# POST /v3/feedback

Send feedback to SEC Blast.

**API key:** required. See [Authentication](https://www.secblast.com/docs/authentication).

**Group:** [Feedback](https://www.secblast.com/docs/reference#feedback)

## Parameters

This route takes no parameters.

## Request body

A [FeedbackCreate](https://www.secblast.com/docs/reference/schemas#schema-feedbackcreate) object, as JSON.

| Field | Type | Required | Description |
|---|---|---|---|
| `category` | string | yes | bug: something failed or misbehaved; missing_data: SEC data expected but not there; missing_tool: no route or tool does what was needed; wrong_answer: a value or text is wrong; docs: a description or error message is unclear; other. One of: `bug`, `missing_data`, `missing_tool`, `wrong_answer`, `docs`, `other`. |
| `client` | object \| null | no | The client program, e.g. the MCP client's name and version from its initialize request. |
| `client.name` | string | yes |   |
| `client.version` | string \| null | no |   |
| `context` | object \| null | no | Details such as accession, query and request_id: a JSON object of at most 16 KB as compact JSON. |
| `message` | string | yes | What happened and what was expected: 1 to 4,000 characters after trimming, no NUL. |
| `source` | string | no | Where the feedback comes from; the MCP server sends mcp. One of: `api`, `mcp`. |
| `tool` | string \| null | no | The MCP tool or API route the feedback is about (at most 100 bytes). |

## Responses

| Status | Body | Description |
|---|---|---|
| `201` | [FeedbackCreated](https://www.secblast.com/docs/reference/schemas#schema-feedbackcreated) (`application/json`) | Created |
| `400` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Invalid or unknown parameter, or a body that is not one JSON document (code invalid_body). |
| `401` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Missing, invalid or inactive API key (code unauthorized), or a refused access token (code invalid_token: malformed, unknown key, bad signature, expired, wrong issuer or audience, revoked grant). WWW-Authenticate names the protected-resource metadata (RFC 9728). |
| `403` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | The credential belongs to no organization, or its scope does not cover this route (code forbidden). |
| `415` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | The body is not sent as Content-Type: application/json (code unsupported_media_type). |
| `429` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | The organization sent its most feedback messages of the last hour (code rate_limited, reason feedback, with retry_after_ms and Retry-After: when the oldest of them is an hour old), or the per-second rate limit (code rate_limited). |
| `503` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | The database is unavailable, or this server cannot store feedback yet (code db_unavailable, Retry-After). |
| `default` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Any other error (405, 500, 504). |

## Response body

A `201` carries a [FeedbackCreated](https://www.secblast.com/docs/reference/schemas#schema-feedbackcreated) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | integer (int64) | yes | The feedback's id. |

## Example request

```bash
curl -sS -X POST -H "Authorization: Bearer $SECBLAST_API_KEY" \
  -H "Content-Type: application/json" -d @body.json \
  'https://api.secblast.com/v3/feedback'
```
