Skip to main content
POST
Submit feedback to an organization's feedback URL

Path Parameters

organizationSlug
string
required

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

Required string length: 1 - 63
Pattern: ^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i
Example:

"acme"

Body

application/json
message
string
required

The feedback itself.

Required string length: 1 - 4000
Example:

"The search tool times out when the query has quotes."

title
string

Short summary. When omitted, Notra writes one.

Required string length: 1 - 200
Example:

"Search times out on quoted queries"

kind
enum<string>

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

Available options:
bug,
feature,
praise,
question,
other
Example:

"bug"

sentiment
enum<string>

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

Available options:
negative,
neutral,
positive
Example:

"negative"

source
enum<string>
default:api

Channel the feedback arrived through.

Available options:
mcp,
api,
sdk
Example:

"mcp"

projectId
string

Project to file the feedback under.

Minimum string length: 1
Pattern: ^[A-Za-z0-9_-]{1,100}$
agentClient
string

The agent or client that submitted the feedback.

Required string length: 1 - 200
Example:

"claude-code"

agentModel
string
Required string length: 1 - 200
Example:

"claude-opus-5"

toolVersion
string
Required string length: 1 - 200
Example:

"1.2.0"

userAgent
string
Required string length: 1 - 2048
contextUrl
string<uri>

Page or resource the feedback is about.

Maximum string length: 2048
Example:

"https://docs.example.com/api/search"

externalId
string

Your own identifier for the user or session.

Required string length: 1 - 200
idempotencyKey
string

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

Required string length: 1 - 200
metadata
object

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

Response

Feedback accepted

feedback
object
required
deduplicated
boolean
required

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

Last modified on September 18, 2026