Cabi.Chat API — Tokens de acceso personal

Un token de acceso personal (PAT) es una clave que actúa como tú. Scripts, tareas de CI, un backend en tu propio sitio, tu propio agente de IA: todo lo que llama a Cabi.Chat API en tu nombre lo presenta como Authorization: Bearer <token>.

Qué puede hacer un token

Un token ve exactamente lo que tú puedes ver y cambia exactamente lo que tú puedes cambiar, nada más. Todas las reglas de las tarjetas valen para él como en la app: las tarjetas mantienen su visibilidad, y una tarjeta que crea empieza como privada, igual que una que creas tú. Quien lo tenga actúa como tú, así que trátalo como una contraseña: fuera del texto de las tarjetas, de los chats, de las publicaciones y de los archivos compartidos.

Crear

• En la app: Perfil → Tokens de acceso personal → ponle un nombre (ci, laptop, script) → Crear token.
• Por la API, desde una sesión iniciada (un token no puede crear tokens): POST /v0/my/pats con {"name": "ci"} y un Idempotency-Key.

El token se muestra una sola vez. La respuesta también puede ofrecer una descarga única de un pequeño archivo con la clave; ábrelo tú mismo y nunca compartas ese enlace. Cabi.Chat guarda solo una huella del token, así que un token perdido no se puede volver a mostrar: crea uno nuevo y revoca el anterior. Repetir una creación: Cabi.Chat API — Crear tarjetas: idempotencia y límites

Los tokens empiezan por cabi_pat_, lo que facilita que los escáneres de secretos los detecten.

Gestionar

• GET /v0/my/pats: nombre, una vista previa corta del token, cuándo se usó por última vez, si está revocado o no. Nunca el token en sí.
• POST /v0/my/pats/{nonce}/revoke: el token deja de funcionar en la siguiente petición. Sigue en la lista como revocado.
• DELETE /v0/my/pats/{nonce}: revocar y quitar de la lista.

Límites

• Un token por agente. Da un token solo a un agente o script de confianza, un token a cada uno, para poder revocar uno sin tocar los demás. Revoca los que ya no uses.
• Si un token puede haberse filtrado. Revócalo y revisa la lista por si hay tokens que no reconoces.
• Configuración por un oráculo de Cabi.Chat. Con tu acuerdo, un oráculo de Cabi.Chat puede configurar tu página por ti. Recibes un aviso en el chat y su acceso aparece en tu lista con el nombre del asistente. Revócalo cuando quieras en Perfil → Tokens de acceso personal, o pídeselo al asistente. Cómo quedarte con la página: Telegram en lugar de contraseñas: entra con la cuenta que ya usas
• Los oráculos que alojas tú mismo no usan tu token: Cabi.Chat API — Apps