> This page is for Plataforma, version Herdado.
> For other versions, use one of these documentation indexes:
> - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt
> - V4 experimental: https://next.developer.frame.io/platform/v4-experimental/llms.txt
> - Herdado: https://next.developer.frame.io/platform/v2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://next.developer.frame.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://next.developer.frame.io/_mcp/server.

# Códigos de erro da API

A API do Frame.io pode retornar os seguintes erros comuns:




| Código | Detalhes | Motivo(s) |
| ---------- | ---------- | ---------- |
| `401` | **Não autorizado** — token de API inválido.Verifique se você está usando a autenticação por token Bearer e se está passando seu token pelo cabeçalho Autorização. |  |
| `402` | **Uso excedido** — Você ultrapassou os limites do seu plano do Frame.io. |  |
| `403` | **Proibido** — Você não tem acesso a esse recurso.Retornado tanto para acesso de usuário quanto para escopo de token. |  |
| `404` | **Não encontrado** — Recurso não encontrado. | O recurso foi movido ou excluído. |
| `422` | **Argumentos inválidos** — Um ou mais parâmetros fornecidos eram inválidos. |  |
| `429` | **Taxa limitada** — Você atingiu o limite de taxa da API. |  |
| `500` | **Erro do servidor** — Nosso servidor não sabe como interpretar sua solicitação ou não conseguiu concluí-la dentro do prazo disponível (30 segundos). | URL ou corpo da solicitação inválido, ou impossibilidade de conclusão por algum outro motivo. |




# Solução de erros comuns

Ao usar um token de API válido para realizar tarefas comuns, os erros mais frequentes são `403`, `404` e `500`.Um erro **403** geralmente indica um dos três cenários a seguir:
1. O token usado na solicitação e/ou o Usuário ao qual o token pertence não possui acesso suficiente à área da Conta do Frame.io onde o recurso foi solicitado.
2. O token não possui [escopos]() suficientes para o recurso solicitado.Por exemplo: chamar `GET /comments/` sem o escopo `comments.read`.
3. Um problema de tráfego de rede está impedindo que a API do Frame.io processe a solicitação.*Se você suspeita que suas solicitações estão sendo bloqueadas por um problema de tráfego de rede, entre em contato com o Suporte ao cliente.*

Um erro **404** geralmente indica que um recurso não existe mais. Ele foi movido ou excluído.Um erro **500** geralmente indica que o URL ou o corpo da solicitação estão incorretos, mas também pode ocorrer quando não é possível concluir a solicitação dentro do prazo disponível (30s).

# Limitação de taxa

A API do Frame.io aplica limites de taxa por token.O limite padrão para um token é de 50 chamadas por segundo.Alguns métodos têm limites mais baixos (por exemplo, a chamada POST `/assets/:id/children` tem uma taxa limitada a 5 ativos por segundo).

Todos os limites estão sujeitos a alterações e, quando atingidos, retornam um erro HTTP 429.Sugerimos usar uma abordagem de recuo exponencial para lidar com a limitação de taxa.

Confira [nosso guia](./rate-limits) sobre limites de taxa para saber mais.