Skip to main content
POST
Submit feedback with an API key

Authorizations

Authorization
string
header
required

Send your API key in the Authorization header as Bearer API_KEY.

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