> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/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="scope-and-permissions">
  ## Ámbito y permisos
</div>

Un PAT te pertenece y está asociado a tu cuenta (tu cuenta de Teams o tu empresa). No está vinculado a una única organización; no existe un «PAT de organización» ni un «PAT de Enterprise». Esto se diferencia de los [usuarios de servicio](/es/api-reference/authentication#service-user-scopes), que se crean a nivel de organización o de Enterprise.

| | Token de acceso personal |
| - | - |
| **Pertenece a** | Tu usuario, dentro de una cuenta |
| **Dónde se gestiona** | La pestaña **PATs** de **Settings > API de Devin**, en cualquier organización o en Settings de Enterprise |
| **Qué puede invocar** | `/v3/organizations/{org_id}/*` para cualquier organización a la que tengas acceso; `/v3/enterprise/*` si dispones de los permisos de Enterprise correspondientes |

Cada solicitud selecciona la organización. Los endpoints de organización la indican en la ruta de la URL (`/v3/organizations/{org_id}/...`) y la solicitud se autoriza según tu acceso y tu rol en esa organización. Una solicitud para una organización a la que no tengas acceso fallará.

El token tiene los mismos permisos que tu usuario. Todo lo que puedas hacer en la aplicación web, podrás hacerlo con tu PAT, y nada más.

Para crear, rotar o revocar PATs, necesitas el permiso **Gestionar claves de API** en la organización cuya configuración estés viendo, o **Gestionar claves de API de la cuenta** a nivel de cuenta. Este permiso controla quién puede gestionar tokens; no cambia lo que un token puede hacer.

Las cuentas de Enterprise también tienen una organización interna que solo almacena Settings a nivel Enterprise. No es un espacio de trabajo. Las solicitudes de PAT dirigidas a ella se rechazan con `403`, así que utiliza siempre el ID de una organización secundaria.

<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 [claves de API 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. Si no estás seguro de cuál usar, consulta la [comparación](/es/api-reference/authentication#personal-access-token-or-service-user).

<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**, en cualquier organización o en Settings de Enterprise. La pestaña muestra los mismos tokens en ambos casos (consulta [Ámbito y permisos](#scope-and-permissions)).

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 la cabecera `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 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 con **Gestionar Settings de Enterprise** configuran la política (y gestionan las solicitudes de aprobación) 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 con **Gestionar claves de API de la cuenta** 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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.