API y agentes de IA

Scopes, límites y errores de autorización

Corrige 401, 403, 429 y alcances insuficientes sin ampliar una credencial innecesariamente.

Actualizado el 28 de agosto de 2026

  • 401 indica token ausente, inválido, vencido o destinado a otro recurso.
  • 403 indica que el token es válido pero su scope, rol u organización no permiten la operación.
  • 404 puede ocultar un recurso de otra organización; no confirma que exista.
  • 409 indica conflicto o una intención idempotente incompatible.
  • 429 indica límite por minuto; espera el periodo indicado y reduce frecuencia.

Scopes disponibles

  • account:read para identidad y organización.
  • projects:read y projects:write para consultar o solicitar proyectos.
  • deployments:read y jobs:read para seguimiento.
  • quotas:read para capacidad comercial visible.
Prefiere una credencial nueva y mínima

Si una integración necesita otro alcance, crea un token separado con vencimiento en lugar de reutilizar una credencial amplia y permanente.