Skip to main content
POST
Send feedback

Authorizations

Authorization
string
header
required

An API token for one organization. You create and revoke tokens in the dashboard. A token scoped to one App can reach only that App, so give that kind of token to an agent. An organization-wide token can create a short-lived one with POST /api/tokens.

Scopes

apps:write
OAuth

Change the organization's Apps: edit files, run commands, deploy, and manage Secrets.

apps:write
DPoP

Headers

Idempotency-Key
string

A key that identifies this request for retries, up to 200 printable characters. A retry with the same key and input returns the first request's result instead of repeating the work. If you omit the key, the API generates one and returns it in the Idempotency-Key response header.

Required string length: 1 - 200

Body

application/json
message
string
required

The feedback, up to 10,000 characters. Say what you tried, what happened, and what you expected.

Required string length: 1 - 10000
type
enum<string>
default:general

What kind of feedback it is: bug for something broken, friction for something that works but is hard to use, or general for anything else. Default: general.

Available options:
bug,
friction,
general

Response

The saved feedback.

id
string
required

The feedback's ID, which starts with fbk_.

type
enum<string>
required

What kind of feedback it is.

Available options:
bug,
friction,
general
message
string
required

The feedback.

created_at
string<date-time>
required
Example:

"2026-10-03T14:01:30.000Z"