Pular para o conteúdo

Erros e limites

Códigos de erro, status de execução e limite de disparos.

Erros

StatusCódigoSignificado
400invalid_requestCorpo inválido ou grant_type diferente de client_credentials.
401invalid_client / invalid_tokenCredenciais erradas, token ausente ou expirado, ou chave revogada. Peça um novo token.
403insufficient_scopeA chave não tem a permissão exigida pelo endpoint.
404not_foundO recurso não existe ou está fora dos ambientes da chave.
409overlap / pipeline_inactiveExecução anterior ainda em andamento com a política “pular”, ou pipeline inativo.
429rate_limited / queue_fullLimite de disparos atingido ou fila cheia. Respeite o cabeçalho Retry-After.

Execuções e limites

  • Os status possíveis são queued, pending, running e retrying, e os finais succeeded, failed e canceled. Etapas de workflow também podem ficar skipped.
  • 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”.