Skip to main content
POST
Submit Feedback
Send one request per distinct issue, after you have resolved it or given up, so the report can say what you tried and any workaround that worked. Agents connected to the MCP server send the same report with the submit_feedback tool; both land in the same place. A useful report carries:
  • The exact request. The URL with its query string, or the tool arguments, in request.
  • What you expected and what came back instead, in message.
  • Request IDs. Data API and Monitoring responses carry an X-Request-ID header, and MCP tool errors from the API include (request ID ...). Quote the IDs of the responses involved; they are how Blockworks finds the request in its logs.
Submissions are stored by Blockworks and attributed to the account behind your API key, so leave out personal or sensitive data. They are free and do not count against usage. Each user can send up to 60 an hour.
If a request times out or returns 503, resend it with the same Idempotency-Key. Copies that share a key count as one submission.

Authorizations

X-Blockworks-API-Key
string
header
required

Headers

Idempotency-Key
string

A value you choose, up to 128 characters, that ties retries of one submission together. Send the same key when you resend after a timeout or a 503, and the copies count as one submission.

Maximum string length: 128

Body

application/json
category
enum<string>
required

bug: something failed or returned wrong results. data_quality: data that is missing, stale, or wrong. feature_request: data or a capability you needed and could not find. Case does not matter.

Available options:
bug,
data_quality,
feature_request
message
string
required

What happened, what you expected, what you tried, and any workaround that worked. Include the request IDs of the responses involved: the X-Request-ID header on Data API and Monitoring responses. Up to 4,000 characters; longer text is cut.

Maximum string length: 4000
tool
string

The MCP tool the report is about, if any, such as tabular_data. Up to 128 characters.

Maximum string length: 128
endpoint
string

The API endpoint the report is about, if any, such as GET /query/tabular/assets. Up to 512 characters.

Maximum string length: 512
request
string

The exact request you made: the URL, or the tool arguments as JSON. Up to 2 KB; longer text is cut.

Maximum string length: 2048
agent
string

The agent or client sending the report, such as Claude Code or your own agent's name and version. Up to 128 characters.

Maximum string length: 128

Response

The submission was stored.

error
string | null
required

Always null on success.

data
object
required