POST /v3/feedback
Send feedback to SEC Blast.
API key: required. See Authentication.
Group: Feedback
Parameters
This route takes no parameters.
Request body
A 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 (application/json) | Created |
400 | Problem (application/problem+json) | Invalid or unknown parameter, or a body that is not one JSON document (code invalid_body). |
401 | 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 (application/problem+json) | The credential belongs to no organization, or its scope does not cover this route (code forbidden). |
415 | Problem (application/problem+json) | The body is not sent as Content-Type: application/json (code unsupported_media_type). |
429 | 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 (application/problem+json) | The database is unavailable, or this server cannot store feedback yet (code db_unavailable, Retry-After). |
default | Problem (application/problem+json) | Any other error (405, 500, 504). |
Response body
A 201 carries a FeedbackCreated object.
| Field | Type | Required | Description |
|---|---|---|---|
id | integer (int64) | yes | The feedback's id. |
Example request
curl -sS -X POST -H "Authorization: Bearer $SECBLAST_API_KEY" \
-H "Content-Type: application/json" -d @body.json \
'https://api.secblast.com/v3/feedback'Markdown version: /docs/reference/post-feedback.md