> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tokens de acceso personal

> Autentícate con tu usuario para acceder a la API de forma programática

<div id="overview">
  ## Resumen general
</div>

Los tokens de acceso personal (PAT) permiten a los usuarios humanos autenticarse de forma programática bajo su propia identidad. A diferencia de las API key de usuario de servicio (que autentican como un usuario de servicio no humano), un PAT autentica como **tú**: el usuario humano que creó el token.

| Tipo de token                      | Se autentica como               | Identidad                            | Permisos                               |
| ---------------------------------- | ------------------------------- | ------------------------------------ | -------------------------------------- |
| **API Key de Usuario de Servicio** | Usuario de servicio (no humano) | La identidad del usuario de servicio | El rol asignado al usuario de servicio |
| **Token de Acceso Personal**       | Usuario (humano)                | Tu identidad de usuario              | Tus permisos y membresías de org       |

Todas las credenciales de API usan el formato de prefijo `cog_`. Ambos tipos de token se usan de forma idéntica en la cabecera `Authorization`:

```bash theme={null}
curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $YOUR_PAT"
```

<div id="when-to-use-pats">
  ## Cuándo usar PATs
</div>

Los PATs están diseñados para situaciones en las que necesitas acceso programático a la API **en tu propio nombre**:

* **Scripts y herramientas personales** — automatiza tus propios flujos de trabajo sin un usuario de servicio compartido
* **Desarrollo local** — prueba integraciones con la API usando tu propia cuenta
* **Automatización de corta duración** — scripts puntuales que deben atribuirse a ti

Para integraciones de producción, pipelines de CI/CD y automatización compartida, usa [API keys de usuarios de servicio](/es/api-reference/authentication#service-users-recommended-for-automation) en su lugar. Los usuarios de servicio proporcionan mejores registros de auditoría, gestión centralizada de claves y controles de RBAC.

<div id="creating-and-managing-pats">
  ## Creación y gestión de PAT
</div>

Gestiona tus PAT desde la pestaña **PAT** de la página de Settings de **Devin API**.

1. **Crea un PAT** — asígnale un nombre y una fecha de vencimiento. El token comienza con `cog_` y solo se muestra una vez al crearlo.
2. **Usa el token** en el header `Authorization`, igual que una API key de usuario de servicio. Cada llamada a la API se autentica con tu cuenta de usuario: se aplican tus permisos, pertenencia a organizaciones y registro de auditoría.
3. **Rota un PAT** — genera un nuevo secreto para un token existente sin cambiar su nombre; el secreto anterior deja de funcionar de inmediato.
4. **Revoca un PAT** — invalida el token en cualquier momento.

Los PAT también se aceptan en endpoints en tiempo real, como el WebSocket en vivo de ACP, por lo que herramientas como Devin CLI y los clientes de escritorio pueden autenticarse con un PAT.

<div id="enterprise-governance">
  ## Gobernanza de Enterprise
</div>

En las cuentas Enterprise, la disponibilidad de PAT se controla mediante una **política de PAT** a nivel Enterprise que se aplica a todas las organizaciones de la Enterprise. Los Admin de Enterprise configuran la política desde la pestaña **Políticas de PAT** de la página de Settings de **Devin API** de la Enterprise.

<div id="policy-modes">
  ### Modos de política
</div>

| Modo                               | Comportamiento                                                                                                                |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Deshabilitado** (predeterminado) | Los miembros no pueden crear ni usar PAT.                                                                                     |
| **Aprobación requerida**           | Los miembros envían una solicitud de PAT; un administrador de Enterprise debe aprobarla antes de que se pueda crear el token. |
| **Autoservicio**                   | Los miembros pueden crear PAT directamente, sujetos a la política de vencimiento.                                             |

<div id="expiration-policy">
  ### Política de vencimiento
</div>

Cuando se habilitan los PAT para una empresa, todos los PAT **deben tener una fecha de vencimiento**, limitada por la duración máxima establecida en la política (**365 días** de forma predeterminada; los Admin pueden configurar un límite menor). Las cuentas no Enterprise (Teams) pueden crear PAT sin fecha de expiración.

<div id="approval-workflow">
  ### Flujo de aprobación
</div>

En **Aprobación requerida**:

1. Un miembro solicita un PAT desde la pestaña PATs (nombre y fecha de vencimiento).
2. Los Admin de Enterprise ven la solicitud en la **Cola de aprobación** y la aprueban o rechazan.
3. Una vez aprobada, el miembro completa la solicitud para generar el token (se muestra una sola vez).
4. Las solicitudes pendientes vencen automáticamente después de **7 días** si no se toma ninguna medida.

Los solicitantes y los administradores reciben notificaciones por correo electrónico en cada etapa del ciclo de vida del token (solicitado, aprobado, rechazado, revocado).

<div id="token-inventory-and-revocation">
  ### Inventario y revocación de tokens
</div>

Los Admin de Enterprise pueden:

* **Ver todos los PAT** de la empresa en el inventario de tokens, incluido su estado de cumplimiento con la política actual
* **Revocar en bloque** tokens (p. ej., tras hacer más restrictiva la política)

Hacer más restrictiva la política (o deshabilitar los PAT) cancela las solicitudes pendientes afectadas, y el inventario señala los tokens existentes que ya no cumplen con ella.

<div id="automatic-revocation">
  ### Revocación automática
</div>

Los PAT de un usuario se revocan automáticamente cuando pierde su pertenencia a la cuenta, incluso si se elimina mediante el desaprovisionamiento de SCIM o cambios en los grupos del IdP.

<div id="security-considerations">
  ## Consideraciones de seguridad
</div>

* Trata los PAT con el mismo cuidado que las contraseñas: proporcionan acceso completo a tu cuenta
* Almacena los PAT en variables de entorno o gestores de secretos, nunca en el código fuente
* Establece el período de expiración más corto que funcione para tu caso de uso
* Revoca los PAT de inmediato si se ven comprometidos
* Prefiere las API keys de usuario de servicio para cualquier automatización compartida o de producción

<div id="next-steps">
  ## Próximos pasos
</div>

* [Resumen de autenticación](/es/api-reference/authentication) — comprender el modelo completo de autenticación
* [Inicio rápido de Teams](/es/api-reference/getting-started/teams-quickstart) — empiece a usar usuarios de servicio