Skip to main content
POST
Submit Feedback

Authorizations

Authorization
string
header
required

API key from Settings > Developer > REST API

Headers

Moda-Version
enum<string>
default:2026-05-01

Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.

Available options:
2026-04-12,
2026-05-01
Example:

"2026-05-01"

Body

application/json
source
string
required

Submitting application.

Allowed value: "voyager"
Example:

"voyager"

kind
enum<string>
required

Who wrote the message: the person, or the agent reporting friction.

Available options:
user,
agent
Example:

"user"

message
string
required

The feedback, free text or markdown.

Required string length: 1 - 5000
category
string
default:other

Friction category: missing_tool, unclear_schema, confusing_docs, broken_behavior, repeated_failure or other. Anything else is recorded as other.

Maximum string length: 40
user_quote
string | null

Optional short quote of what the user asked for, when the agent is reporting.

Maximum string length: 500
context
FeedbackContext · object

Build and session details Voyager attaches; every field optional and bounded.

Unknown fields are ignored (not forbidden) so a newer Voyager can attach a field this Studio does not know yet without the whole submission failing. The thread id is deliberately voyager_thread_id: the fan-out resolves a thread_id key against LangSmith, and a Voyager thread is not a LangSmith trace.

Response

Successful Response

id
string<uuid>
required

Reference id for this submission; also stamped on the internal record.

status
string
required
Allowed value: "accepted"