Skip to content

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.

FieldTypeRequiredDescription
categorystringyesbug: 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.
clientobject | nullnoThe client program, e.g. the MCP client's name and version from its initialize request.
client.namestringyes
client.versionstring | nullno
contextobject | nullnoDetails such as accession, query and request_id: a JSON object of at most 16 KB as compact JSON.
messagestringyesWhat happened and what was expected: 1 to 4,000 characters after trimming, no NUL.
sourcestringnoWhere the feedback comes from; the MCP server sends mcp. One of: api, mcp.
toolstring | nullnoThe MCP tool or API route the feedback is about (at most 100 bytes).

Responses

StatusBodyDescription
201FeedbackCreated (application/json)Created
400Problem (application/problem+json)Invalid or unknown parameter, or a body that is not one JSON document (code invalid_body).
401Problem (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).
403Problem (application/problem+json)The credential belongs to no organization, or its scope does not cover this route (code forbidden).
415Problem (application/problem+json)The body is not sent as Content-Type: application/json (code unsupported_media_type).
429Problem (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).
503Problem (application/problem+json)The database is unavailable, or this server cannot store feedback yet (code db_unavailable, Retry-After).
defaultProblem (application/problem+json)Any other error (405, 500, 504).

Response body

A 201 carries a FeedbackCreated object.

FieldTypeRequiredDescription
idinteger (int64)yesThe feedback's id.

Example request

Shell
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