Feedback

Submit feedback to an organization's feedback URL

Record feedback from an AI agent or integration by posting to the organization's feedback URL, as shown on the Feedback page in the dashboard. No credentials are required. Limited per source IP and per organization.

post/v1/feedback/{organizationSlug}

Request

  • Base URL: https://api.usenotra.com
  • URL: https://api.usenotra.com/v1/feedback/{organizationSlug}
  • Auth: none required

Path parameters

organizationSlugstring required

Your organization slug, as shown in your feedback URL on the Feedback page.

Example:acme

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

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