Erros e limites
Códigos de erro, status de execução e limite de disparos.
Erros
| Status | Código | Significado |
|---|---|---|
| 400 | invalid_request | Corpo inválido ou grant_type diferente de client_credentials. |
| 401 | invalid_client / invalid_token | Credenciais erradas, token ausente ou expirado, ou chave revogada. Peça um novo token. |
| 403 | insufficient_scope | A chave não tem a permissão exigida pelo endpoint. |
| 404 | not_found | O recurso não existe ou está fora dos ambientes da chave. |
| 409 | overlap / pipeline_inactive | Execução anterior ainda em andamento com a política “pular”, ou pipeline inativo. |
| 429 | rate_limited / queue_full | Limite de disparos atingido ou fila cheia. Respeite o cabeçalho Retry-After. |
Execuções e limites
- Os status possíveis são
queued,pending,runningeretrying, e os finaissucceeded,failedecanceled. Etapas de workflow também podem ficarskipped. idempotency_key(opcional, até 200 caracteres): repetir o disparo com a mesma chave devolve a mesma execução.- Workflows seguem a política de sobreposição definida no Estúdio: pular, enfileirar ou rodar em paralelo.
- Limite de 60 disparos por minuto por chave. Consultar status não conta no limite, mas prefira intervalos de 10 segundos ou mais.
- Disparos pela API aparecem em Execuções com a origem “API”.