Skip to main content
POST
Submit feedback envelope (C-FB1)

Body

application/json
signal
enum<string>
required
Available options:
error_telemetry,
bug_report,
quality_rating
payload
Payload · object
required

Signal-specific content

schema_version
string
default:1
Allowed value: "1"
ref
string | null

Prior request_id OR feedback_id this submission refers to

Maximum string length: 128
context
Context · object | null

Free-form caller metadata (opt-in only - may contain request body). Never populated automatically; callers must explicitly opt in. May contain optional attachments: list[AttachmentRef] (≤3) for bug_report signals (C-FBSA1).

Response

Feedback accepted for processing

Response shape for POST /v1/feedback.

Returned with HTTP 202 Accepted. The feedback_id is a server-issued ULID (prefix fbk_) - the keystone primitive that lets customers annotate a specific error instance unambiguously across retries.

feedback_id
string
required

Server-issued ULID with fbk_ prefix, e.g. fbk_01H8K...

received_at
string
required

ISO 8601 timestamp when the submission was accepted

schema_version
string
default:1
Allowed value: "1"