KHkhotan
Feedback

Send feedback to the Khotan team

Stores a feature request, product direction, docs gap, or bug from an agent. The agent states its proposal, the situation it was in, its reason, and whether a person asked it to send it. The server attributes the submission from the API key; for the Slack agent it also records the conversation and the member who asked. Every authenticated caller can send feedback, including the code sandbox's read-only key. Nothing reads submissions back over the API.

post/api/v1/feedback

Request

  • Base URL
    https://app.khotan.com
  • URL
    https://app.khotan.com/api/v1/feedback
  • Auth
    • HTTP bearer
    • or API key in header x-api-key

Request body

kind'feature_request' | 'direction' | 'docs_gap' | 'bug' | 'other' required

What kind of feedback this is.

titlestring required

One line.

proposalstring required

What should be added or changed.

situationstring required

What the agent was doing: the task, its goal, and what it tried.

reasonstring required

Why the agent sent it: what it had to do instead, and what the change would let it or its user do.

origin'agent' | 'user' required

user when a person asked the agent to send it; agent when the agent decided to.

workaroundstring
impact'blocked' | 'workaround' | 'nice_to_have'
area'api' | 'cli' | 'mcp' | 'slack_agent' | 'dashboard' | 'templates' | 'skills' | 'docs' | 'other'
capabilityIdsstring[]

Khotan action ids this is about. A requested action may not exist yet.

threadIdstring

The caller's own conversation or session id.

modelstring
clientstring

The agent product, such as cursor or claude-code.

Response

The stored submission's id and time, and a note to carry on.

idstring required
createdAtstring required

ISO 8601 timestamp.

messagestring required

Changes

No recorded changes to this operation across all 1 revision of this API.