Feedback

Submit feedback with an API key

Changed on

Record feedback for the organization that owns the credential. Requires an API key with the feedback.write scope. Agents and MCP servers should post to the organization's feedback URL instead.

post/v1/feedback

Request

  • Base URL: https://api.usenotra.com
  • URL: https://api.usenotra.com/v1/feedback
  • Auth: HTTP bearer

Request body

messagestring required

The feedback itself.

titlestring

Short summary. When omitted, Notra writes one.

kind'bug' | 'feature' | 'praise' | 'question' | 'other'

What kind of feedback this is. When omitted, Notra classifies it.

sentiment'negative' | 'neutral' | 'positive'

Overall sentiment. When omitted, Notra classifies it from the message.

source'mcp' | 'api' | 'sdk'

Channel the feedback arrived through.

projectIdstring

Project to file the feedback under.

agentClientstring

The agent or client that submitted the feedback.

agentModelstring
toolVersionstring
userAgentstring
contextUrlstring uri

Page or resource the feedback is about.

externalIdstring

Your own identifier for the user or session.

idempotencyKeystring

Submitting the same key twice returns the original feedback instead of creating a duplicate.

metadataobject

Arbitrary JSON attached to the feedback, up to 8 KB.

Example request

{
  "message": "The search tool times out when the query has quotes.",
  "title": "Search times out on quoted queries",
  "kind": "bug",
  "sentiment": "negative",
  "source": "mcp",
  "agentClient": "claude-code",
  "agentModel": "claude-opus-5",
  "toolVersion": "1.2.0",
  "contextUrl": "https://docs.example.com/api/search"
}

Response

Feedback accepted

deduplicatedboolean required

True when an existing feedback with the same idempotencyKey was returned.

Example response

{
  "feedback": {
    "source": "mcp",
    "kind": "bug",
    "sentiment": "negative",
    "status": "new"
  }
}

Changes