Skip to main content
POST
Send a feedback report: what you tried, what happened, and what was confusing or missing

Headers

feedback-timestamp
string
Pattern: ^\d{1,12}$
feedback-signature
string
Pattern: ^[0-9a-f]{64}$

Path Parameters

slug
string
required
Required string length: 1 - 64

Body

application/json
observation
string
required
Required string length: 10 - 4000
goal
string
Required string length: 1 - 500
outcome
enum<string>
Available options:
succeeded,
friction,
blocked
category
enum<string>
Available options:
documentation,
missing_capability,
error,
confusing_output,
access,
other
reference
string
Required string length: 1 - 200
surface
enum<string>
Available options:
web,
api,
mcp,
cli,
other
productVersion
string
Required string length: 1 - 64
requestReference
string
Required string length: 1 - 128
agent
string
Required string length: 1 - 200
invite
string
Required string length: 1 - 64
metadata
object

Response

Default Response

id
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
receivedAt
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
repeat
boolean
required
message
string
required
Minimum string length: 1