> ## 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.

# Comentarios

> Cuéntale a Croma cuando algo falla, no es claro o falta, desde la API o desde un cliente MCP.

Envía un comentario cuando una llamada devuelve un error o un resultado vacío
que no esperabas, una respuesta no es clara, o la fuente o el campo que
necesitas no existe. Funciona igual desde la API y desde la herramienta MCP
`submit_feedback`.

> [!NOTE]
>
> Croma revisa los comentarios, no los responde y no se pueden listar ni
> consultar. No consumen créditos. No incluyas credenciales, datos personales
> ni datos de pago.

## Enviar un comentario

`POST /feedback`

| Campo | Tipo | Notas |
| - | - | - |
| `type` | string | **Obligatorio.** `issue` (algo falla), `question` (algo no es claro) o `request` (algo debería existir o cambiar). |
| `content` | string | **Obligatorio.** Qué pasó o qué necesitas, hasta 20.000 caracteres. |
| `request_id` | string | El `X-Request-Id` de la llamada a la que se refiere, si lo tienes. |

```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 el mismo comentario el mismo día es seguro: recibes el `id` original
con `"status": "already_received"`, así que si una llamada expira, envíala de
nuevo. El límite es de 20 comentarios por hora por organización. Al superarlo,
la respuesta es un `429` con un encabezado `Retry-After`.

> **[Referencia completa](https://docs.usecroma.com/es/api-reference/overview.md)**
>
> Esquemas de solicitud y respuesta de cada endpoint.


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