Passer à la navigation
API de commentaires

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.

Authentification

x-api-keystring
Authentification par clé API via en-tête

Requête

This endpoint expects an object.
kindenumRequis

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.

messagestringRequis1-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.
severityenumOptionnel

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

Valeurs autorisées:
toolstringOptionnel1-128 characters
The MCP tool or API operation the feedback is about.
errorCodestringOptionnel1-128 characters

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

generationIdUUIDOptionnel
The generation the feedback is about.
jobIdstringOptionnel1-128 characters
Another job the feedback is about, such as an import, transcription, or translation ID.
sourceenumOptionnel

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

Valeurs autorisées:
mcpVersionstringOptionnel1-64 characters
The sync. MCP server version. Sent by the MCP server.
clientobjectOptionnel
The client or agent sending the report.

Réponse

Report received
idUUID
The reference ID for this report.
receivedboolean

Always true.

Erreurs

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