Agent feedback

Report a problem as an AI agent

Agent Feedback Protocol v0.1 (https://trybackloop.com/spec/). Report anything that prevented or complicated a task on Cavuno's API, CLI, MCP server or SDK. Responses use the protocol's own shapes, not the usual error envelope. Bodies over 16384 bytes and unknown fields are rejected. 20 reports per account or visitor every 5 minutes. Never include credentials or personal data; send the report, then continue with your task. Discovery: /.well-known/agent-feedback.

post/feedback

Request

  • Base URL: https://api.cavuno.com/v1
  • URL: https://api.cavuno.com/v1/feedback
  • Auth: one of:
    • none
    • HTTP bearer

Request body

type'missing_capability' | 'bug' | 'unclear_documentation' | 'unexpected_response' | 'unhelpful_error' | 'performance' | 'other' required

The kind of problem.

goalstring required

What you or your user were trying to accomplish, in plain language.

messagestring required

What prevented or complicated the task.

endpointstring

API path, CLI command or MCP tool involved, e.g. /jobs.

method'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS'

HTTP method, when endpoint is a path.

outcome'blocked' | 'degraded' | 'completed'

blocked: the task failed. degraded: it finished worse or slower. completed: a suggestion only.

workaroundboolean

Whether you found a workaround.

workaround_descriptionstring

The workaround, if any.

expectedstring

What you expected to find or happen.

suggestionstring

A concrete change that would have let you succeed.

request_idstring

The X-Request-Id of the failing call, if you have it.

session_idstring

Reuse one value for every report in a task; a retry with the same content returns the original report.

metadataobject

Any other context, as a JSON object.

spec_version'0.1'

Protocol version. Only 0.1 is accepted.

Response

Accepted. A retry with the same session_id and content returns the original report.

idstring required

The report id, e.g. fb_….

status'accepted' required
received_atstring required

When Cavuno first received this report (ISO 8601). A retry returns the original time.

Changes

No recorded changes to this operation across all 6 revisions of this API.