Ir para a navegação
API de feedback

Submit Feedback

Report a problem you hit with the API or the sync. MCP server, such as an error that didn't say what to fix, a wrong result, a missing capability, or a workaround you needed. Send one report per problem. The sync. team reviews reports daily. Works with an API key, an OAuth access token, or a Studio session. Submitting feedback doesn't change, retry, or cancel any job. Limited to 30 reports per minute per caller. Unknown body fields return 400.

Autenticação

x-api-keystring
Autenticação de chave de API via cabeçalho

Solicitação

This endpoint expects an object.
kindenumObrigatório

The kind of problem: confusing_error (an error that didn’t say what to fix), bug (a wrong result or crash), missing_capability (an endpoint, tool, or option you needed), workaround (extra steps you had to take), docs (documentation or a description that misled you), or other.

messagestringObrigatório1-4000 characters
What you tried, what happened, and what would have helped. Include the exact error text. Don't include personal data or secrets. 1 to 4,000 characters.
severityenumOpcional

blocker: you couldn’t finish. major: you finished with a workaround. minor: an annoyance.

Valores permitidos:
toolstringOpcional1-128 characters
The MCP tool or API operation the feedback is about.
errorCodestringOpcional1-128 characters

The error code you received, such as an errorCode field.

generationIdUUIDOpcional
The generation the feedback is about.
jobIdstringOpcional1-128 characters
Another job the feedback is about, such as an import, transcription, or translation ID.
sourceenumOpcional

Where the report comes from. Defaults to api. The sync. MCP server sends mcp.

Valores permitidos:
mcpVersionstringOpcional1-64 characters
The sync. MCP server version. Sent by the MCP server.
clientobjectOpcional
The client or agent sending the report.

Resposta

Report received
idUUID
The reference ID for this report.
receivedboolean

Always true.

Erros

400
Bad Request Error
401
Unauthorized Error
429
Feedback Too Many Requests Error
500
Internal Server Error