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

# Feedback

> Conte à Croma quando algo falha, não está claro ou falta, pela API ou por um cliente MCP.

Envie um feedback quando uma chamada devolver um erro ou um resultado vazio
inesperado, uma resposta não estiver clara, ou a fonte ou o campo de que você
precisa não existir. Funciona igual pela API e pela ferramenta MCP
`submit_feedback`.

> [!NOTE]
>
> A Croma revisa os feedbacks, não os responde e eles não podem ser listados nem
> consultados. Não consomem créditos. Não inclua credenciais, dados pessoais
> nem dados de pagamento.

## Enviar um feedback

`POST /feedback`

| Campo | Tipo | Notas |
| - | - | - |
| `type` | string | **Obrigatório.** `issue` (algo falha), `question` (algo não está claro) ou `request` (algo deveria existir ou mudar). |
| `content` | string | **Obrigatório.** O que aconteceu ou o que você precisa, até 20.000 caracteres. |
| `request_id` | string | O `X-Request-Id` da chamada a que se refere, se você o tiver. |

```bash theme={"dark"}
curl https://api.croma.run/feedback \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "request", "content": "Property liens for Bogota are not covered by any endpoint." }'
```

```json theme={"dark"}
{
  "data": {
    "id": "fbk_6f1c2b1e-0d6a-4f7e-9a53-2f8f6f0d9a11",
    "created_at": "2026-10-23T18:04:11.000Z",
    "status": "received"
  }
}
```

Reenviar o mesmo feedback no mesmo dia é seguro: você recebe o `id` original
com `"status": "already_received"`, então se uma chamada expirar, envie de
novo. O limite é de 20 feedbacks por hora por organização. Ao ultrapassá-lo, a
resposta é um `429` com um cabeçalho `Retry-After`.

> **[Referência completa](https://docs.usecroma.com/pt/api-reference/overview.md)**
>
> Esquemas de requisição e resposta de cada endpoint.


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