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

> ## Agent Instructions
> Leia /llms.txt antes de explorar páginas. A API HTTP usa Authorization: Bearer com o JWT da conta. A chave kl_live_ serve só ao assistente MCP e não substitui o JWT. Não invente rotas, hosts públicos, SDKs ou CLI. companyId e userId vêm da sessão. Consultas não aceitam SQL. Exclusão no assistente exige confirm=true. O webhook público é POST /webhook/leads.

# Tratar erro 400, 401 e 403

> Leia success, o HTTP e o code. Corrija o corpo, o token ou a permissão. Não duplique criação.

> [!NOTE]
>
> Índice de códigos: [Erros e códigos](https://docs.kinglog.com.br/pages/reference/erros.md).

Leia `success` antes de usar `data`. O HTTP diz a classe. O `code` diz o motivo.

**1. 400, corpo recusado**

Corrija o campo. Na consulta, `QUERY_INVALID`. No contato ou no webhook de lead, `EMAIL_FORMAT_INVALID`. Não repita o mesmo JSON.

**2. 401, sem credencial**

Falta o JWT, ele expirou, ou a chave `kl_live_` foi revogada (`MCP_API_KEY_INVALID`). Sessão sem empresa e usuário: `MISSING_CONTEXT`.

**3. 403, sem permissão**

A conta não pode aquele recurso, ou a chave tem `grants` menores. A tabela está em [Autenticação](https://docs.kinglog.com.br/pages/authentication.md).

Repita só `5xx` e `429`, com espera. Se o POST de criação atrasou, não envie outro: a tarefa, o lead ou a despesa podem ter sido gravados.


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