> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doglytdc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Erros

> Formato e lista completa dos códigos de erro da API e do MCP do Scripts.

Todo erro da API do Scripts (e das ferramentas do MCP) tem o mesmo formato:

```json theme={null}
{
  "code": "INVALID_FORM_BODY",
  "message": "Envie um texto de 1 a 200 caracteres.",
  "errors": { "query": ["obrigatório"] }
}
```

| Campo | O que é |
| - | - |
| `code` | Código fixo, bom para o seu programa decidir o que fazer |
| `message` | Texto em português para mostrar a pessoas |
| `errors` | Opcional: erros por campo |

No MCP, o mesmo erro chega como texto `CÓDIGO: mensagem` com `isError: true`. Veja também [Erros do MCP](https://docs.doglytdc.dev/pt-BR/scripts/mcp/errors.md).

## Status HTTP

| Status | Significado |
| - | - |
| `400` | Pedido com campo errado ou ação impossível |
| `401` | Sem autenticação ou token inválido |
| `403` | Sem permissão ou sem escopo |
| `404` | Script, arquivo, função, documento etc. não existe |
| `405` | Método não aceito na rota |
| `409` | Conflito: a branch mudou, a versão já existe, confirmação necessária |
| `402` | Sem créditos ou saldo para a ação |
| `413` | Pedido ou pacote grande demais |
| `429` | Muitas chamadas: espere um minuto |
| `500` / `502` / `503` | Falha do servidor ou de um serviço externo; tente de novo |

## Todos os códigos

Lista tirada do código do servidor (69 códigos). "…" marca partes que mudam a cada caso (nome, número, versão).

| Código | HTTP | Mensagens do servidor | O que fazer |
| - | - | - | - |
| `AI_FAILED` | 502 | Falha ao falar com a IA DoglyTdc. Falha na IA DoglyTdc. | |
| `AI_NO_BALANCE` | 402 | IA DoglyTdc sem saldo no momento. | |
| `AI_UNAVAILABLE` | 503 | IA indisponível no momento. | |
| `ALREADY_DECIDED` | 409 | Este código já foi decidido. Este pedido já foi decidido. | |
| `BAD_CHANNEL` | 400 | Escolha um canal de texto ou de anúncios. | |
| `BOT_NOT_CONFIGURED` | 409 | Configure o bot primeiro. Falta o Client Secret do bot. O dono do bot ainda não colou o ID do aplicativo e o Client Secret. | |
| `BUILD_FAILED` | 400 | Erro de sintaxe: … | Corrija o erro de sintaxe ou de `require` em `src/`. |
| `CREATE_FAILED` | 400 | Não foi possível criar o script. Não foi possível salvar a versão. | |
| `DISCORD_ERROR` | 502 | Discord recusou o arquivo (HTTP …). | |
| `ENV_INCOMPLETE` | 409 | Falta o ID do aplicativo ou a chave pública nos segredos do servidor. Falta o token do bot nos segredos do servidor. | |
| `ENV_NOT_BOUND` | 403 | Os segredos do servidor não são deste script. | |
| `EXPIRED` | 409 | Este pedido expirou. A IA precisa pedir de novo. | |
| `IDENTITY_MANUAL` | 403 | O dono definiu esta conexão como "…". Use whoami para ler. | |
| `IMAGE_TOO_LARGE` | 413 | Imagem grande demais (máx. … KB). | |
| `INSUFFICIENT_CREDITS` | 402 | Sem créditos de IA na conta do dono do script. | O dono do script precisa de créditos. |
| `INTERNAL` | 500 | Falha ao criar o webhook. Falha ao gerar o token. Falha no repositório. | Erro interno; tente de novo. |
| `INVALID_CODE` | 400 | Código inválido. Digite o código de 8 letras mostrado no terminal. | |
| `INVALID_FORM_BODY` | 400 | Cole o token do bot para trocar dos segredos do servidor para chaves coladas. Cole o token do bot. Corpo inválido. Envie JSON válido. Envie script\_id: os créditos saem do dono do script. Envie um texto de 1 a 200 caracteres. … | Confira os campos; `errors` diz qual. |
| `INVALID_IMAGE` | 400 | Envie PNG, JPG, GIF ou WEBP. | |
| `INVALID_RETURN` | 400 | Endereço de volta inválido. | |
| `INVALID_STATE` | 409 | Este pedido não está em atendimento. Este pedido não está mais aguardando pagamento. Este pedido não pode mais ser cancelado. Este pedido não pode ser concluído. Este pedido não pode ser reembolsado. Só pedidos pagos têm atendimento. | |
| `INVALID_TOKEN` | 400 | O Discord recusou este token do bot. O Discord recusou o token salvo. Troque o segredo do token. | |
| `LIMIT` | 400 | Máximo de 20 conexões ativas. Revogue uma antes. Máximo de … itens por conexão. Apague algum antes. Máximo de … conexões ativas. Revogue algumas em Conexões MCP antes. | |
| `MAX_WEBHOOKS` | 400 | Limite de 5 webhooks por script. | Apague um webhook (máx. 5). |
| `MESSAGE_GONE` | 404 | A mensagem foi apagada no Discord. Envie de novo. | |
| `METHOD_NOT_ALLOWED` | 405 | Método não permitido nesta rota. Método não permitido. | |
| `MISSING_ACCESS` | 403 | Este token não tem escopos da API de scripts. Este token é de outro script. Só dono/admin do DoglyTdc cria scripts novos. Só o dono do script confere o app no Discord. Só o dono do script corrige o app no Discord. Só o dono do script liga o bot aos segredos do servidor. … | Você não é dono/colaborador ou a ação é só do dono. |
| `MISSING_PERMISSIONS` | 403 | Por enquanto só a equipe DoglyTdc cria scripts. O sistema aberto está em desenvolvimento. | |
| `MISSING_SCOPE` | 403 | Falta o escopo …. | Peça o escopo que falta ao criar o token ou a conexão. |
| `NOT_A_BOT` | 400 | Este script não é um Bot Discord. | |
| `NOT_A_PLAN` | 400 | Este item não é um plano. | |
| `NOT_FOUND` | 404 | Conexão não encontrada ou já revogada. Conexão não encontrada. Item de contexto não encontrado nesta conexão. Pedido de aprovação não encontrado nesta conexão. Pedido não encontrado. Rota inexistente. … | |
| `NO_CHANNEL` | 400 | Escolha o canal de envio primeiro. | |
| `NO_CONNECTION` | 400 | Envie a chave dsm\_ que quer revogar. Esta ferramenta só funciona com uma chave de conexão MCP (dsm\_). | |
| `NO_OPTIONS` | 400 | Adicione pelo menos uma opção. | |
| `PANEL_DISABLED` | 409 | Ligue este atendimento antes de publicar. | |
| `PAYLOAD_TOO_LARGE` | 413 | Corpo grande demais. Pacote acima de 2 MB. | Diminua o pacote (máx. 2 MB) ou o pedido. |
| `RATE_LIMITED` | 429 | Espere alguns segundos entre as consultas. IA ocupada: tente de novo em instantes. Limite de 120 mensagens MCP por minuto. Limite de 300 chamadas por minuto. Muitas chamadas. Espere um minuto. Muitas mensagens. Espere um minuto. … | Espere um minuto (`Retry-After`). |
| `REASON_REQUIRED` | 400 | Escreva o motivo da cortesia. | |
| `REVOKED` | 409 | Conexão revogada. | |
| `SAVE_FAILED` | 400 | Não foi possível criar. Não foi possível salvar. | |
| `SEAL_FAILED` | 500 | Não foi possível criptografar o pacote. Nada foi publicado. | |
| `TEMPLATE_FAILED` | 500 | Script criado, mas o modelo não foi salvo. Abra o painel para recuperar. | |
| `TICKET_FAILED` | 502 | Não consegui abrir o atendimento. O bot precisa de \\ | |
| `TOKEN_MISMATCH` | 400 | Este token é de outro aplicativo. O token salvo é de outro aplicativo. | |
| `TOO_MANY` | 409 | Máximo de … modelos. Apague algum antes. Máximo de … modelos. | |
| `TOO_MANY_PANELS` | 409 | No máximo … atendimentos por servidor. | |
| `UNAUTHORIZED` | 401 | Autorização revogada. Chave MCP inválida ou revogada. Envie Authorization: Bearer \<token>. Sessão expirada. Entre de novo. Token de script inválido ou revogado. Token inválido, expirado ou revogado. | Token ausente, errado ou revogado. Gere outro. |
| `UNAVAILABLE` | 503 | Não foi possível acessar os dados agora. Não foi possível concluir agora. Não foi possível conferir a chave agora. Não foi possível conferir a permissão agora. Não foi possível conferir a permissão. Não foi possível conferir agora. … | Falha temporária; tente de novo. |
| `UNKNOWN_AUTHORIZATION` | 404 | Autorização inexistente. | |
| `UNKNOWN_BOT` | 404 | Bot inexistente. | |
| `UNKNOWN_CHANNEL` | 404 | Esse canal não é deste servidor ou o bot não consegue vê-lo. | |
| `UNKNOWN_CODE` | 404 | Código inexistente, já usado ou expirado. Rode o comando de novo. Código inexistente. | |
| `UNKNOWN_COLLECTION` | 404 | Coleção inexistente. | |
| `UNKNOWN_COMMIT` | 404 | Commit inexistente. | |
| `UNKNOWN_DOCUMENT` | 404 | Documento não encontrado. | |
| `UNKNOWN_FILE` | 404 | Arquivo "…" não existe neste ref. | |
| `UNKNOWN_FUNCTION` | 404 | Função inexistente. | |
| `UNKNOWN_GUILD` | 400, 404 | Servidor inválido. O bot não está neste servidor. Adicione-o e clique em Atualizar. | |
| `UNKNOWN_JOB` | 404 | Pedido não encontrado. | |
| `UNKNOWN_MESSAGE` | 404 | Mensagem não encontrada. | |
| `UNKNOWN_PANEL` | 404 | Atendimento não encontrado. Nenhum atendimento neste servidor. | |
| `UNKNOWN_SCRIPT` | 404 | Script inexistente ou sem acesso. Script inexistente. | |
| `UNKNOWN_TEMPLATE` | 404 | Modelo não encontrado. O modelo desta mensagem foi apagado. | |
| `UNKNOWN_TOOL` | 404 | Ferramenta do pedido não existe mais. | |
| `UNKNOWN_WEBHOOK` | 404 | Webhook inexistente. | |
| `UNPROTECTED_CONFIRM` | 409 | A proteção está desligada: o código vai aberto para quem tiver o link. Confirme para publicar assim. | Envie `confirm_unprotected: true` ou ligue a proteção. |
| `UPLOAD_FAILED` | 400 | Não foi possível criar o link da imagem. Não foi possível enviar a imagem. | |
| `VERSION_EXISTS` | 409 | A versão … já existe. | Use outro número de versão. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.