Pipeline de API: tokens de acceso personal
Objetivo: un token de acceso personal para que tu propio Claude Code, tus scripts o tu backend actúen como tú; listar y revocar tus tokens.
Un token ve lo que tú ves y puede cambiar lo que tú puedes cambiar. Más: Cabi.Chat API — Tokens de acceso personal
Pasos
Parte de una sesión iniciada (Pipeline de API: iniciar sesión en Cabi.Chat con Telegram) o de un token que ya tengas.
1. Crear.
POST /v0/my/pats
Idempotency-Key: 7c1e…
{"name": "laptop"}
→ {"pat": {"nonce": "<pat>", "title": "laptop", "token_preview": "cabi_pat_1a2b…9f0e", "revoked": false, "created_at": "…"},
"token": "cabi_pat_…", …}
Guarda token: se muestra una sola vez.
2. Usar.
curl -H "Authorization: Bearer cabi_pat_…" https://api.cabi.chat/v0/my/self
→ 200 {"nonce": "<you>", "first_name": "…", …}
3. Listar. GET /v0/my/pats → {"pats": [{"nonce", "title", "token_preview", "last_used_at", "revoked", "created_at"}], "total"}. Nunca el token en sí.
4. Revocar. POST /v0/my/pats/<pat>/revoke → la fila con "revoked": true. El token deja de funcionar en la siguiente petición; la fila se queda.
5. Eliminar. DELETE /v0/my/pats/<pat> → {"success": true}: revocado y quitado de la lista.
Detrás
- Un token perdido no se puede volver a mostrar: crea uno nuevo y revoca el antiguo.
Reglas
Idempotency-Keyes obligatorio (400 sin él). La misma clave otra vez → 409: el token nunca se envía dos veces.- Solo tú gestionas tus tokens, desde tu propia sesión o un token tuyo; el acceso de configuración de un oráculo en tu cuenta no puede verlos, crearlos ni revocarlos.
- Revoca un token cuando quieras, aquí o en Perfil → Tokens de acceso personal. Revoca los que ya no uses.
Superficie de la API
| Endpoint | Para qué | FE | IA / oráculo |
|---|---|---|---|
POST /v0/my/pats |
Crear | sí | solo tus propios scripts |
GET /v0/my/pats |
Listar | sí | solo tus propios scripts |
POST /v0/my/pats/{nonce}/revoke |
Revocar | sí | solo tus propios scripts |
DELETE /v0/my/pats/{nonce} |
Revocar y quitar | no | solo tus propios scripts |
GET /v0/my/self |
Comprobar el token | sí | sí |
Índice: Pipelines de API — índice