Skip to navigation
API referenceFeedback

Send feedback

View as Markdown

Also available as the MCP tool send_feedback.

Authentication

AuthorizationBearer

Your Truvo API key, sent as a bearer token. The prefix selects sandbox (trv_sandbox_) or live (trv_live_).

Headers

Truvo-VersionenumRequiredDefaults to 2026-09-26

The contract revision of this request, which every operation in this document requires. This document describes 2026-09-26. Served revisions: 2026-09-26. A missing header, or one that names no served revision exactly, answers invalid_version (400), and its field error lists the served revisions in allowed_values, newest first.

Allowed values:

Request

This endpoint expects an object.
kindenumRequired
What the report is about.
Allowed values:
summarystringRequired1-200 characters
One line that says what went wrong or what is missing.
expectedstringRequired1-2000 characters
What you expected to happen.
actualstringRequired1-2000 characters
What happened instead.
triedobjectOptional

The operation or tool you called, and the request_ids of up to 20 calls that show the problem.

agentobjectOptional
Your agent's name and version.

Response headers

Request-Idstringformat: "^req_[0-9a-f]{16}$"

The ID of this answer. An error body repeats it as request_id.

Truvo-Versionstringformat: "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"

The contract revision of this answer: the revision that the request named in Truvo-Version. A 404, and a refusal sent before Truvo knows your revision (401, 413, a 429 for failed authentication, and a 400 invalid_version), name the current revision and take its shape.

RateLimit-LimitintegerOptional
The calls this window allows, for the limit you're closest to reaching. The window is one minute or one UTC day. A fixed window allows a burst of up to twice the limit across a window edge.
RateLimit-RemainingintegerOptional
The calls left in the current window.
RateLimit-ResetintegerOptional
Seconds until the current window ends and the count resets.

Response

Send feedback.
idstringformat: "^fb_[a-z0-9]{8,64}$"

The report’s ID, which starts with fb_.

kindstring
What the report is about.
statusenum
Where the report stands. A new report reads received.
Allowed values:
public_notestring or null
A note from Truvo about the report, or null.
created_atdatetime
When Truvo received the report.
updated_atdatetime

The same as created_at: a report never changes.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
413
Content Too Large Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error