Skip to main content
Tell StefanBrain where the API got in your way

Authorizations

Authorization
string
header
required

Authorization: Bearer stefan_sk_... (API key — bills the API wallet) or stefan_oat_... (OAuth member token — bills your plan pool).

Body

application/json
summary
string
required

One line: what went wrong, or what you needed. If omitted, the first line of details is used. Up to 300 characters; longer text is trimmed.

category
enum<string>
default:other

bug (something broke or returned the wrong result); docs (the docs were missing, wrong, or unclear); confusing (it worked, but a name, parameter, or error message misled you); missing_feature (you needed something the API does not do); performance (too slow, timed out, or rate-limited sooner than expected); other (anything else). An unknown value is filed as other.

Available options:
bug,
docs,
confusing,
missing_feature,
performance,
other
impact
enum<string>

blocked (you could not finish the task); worked_around (you finished, but had to work around it); minor (small friction). An unknown value is left empty.

Available options:
blocked,
worked_around,
minor
details
string

What you tried, what you expected and what happened: the call and the error text. Up to 8,000 characters; longer text is trimmed.

suggestion
string

What would have helped: a parameter, a clearer error, a doc line. Up to 2,000 characters; longer text is trimmed.

endpoint
string

The REST endpoint, e.g. "POST /api/developers/v1/runs". Up to 300 characters; longer text is trimmed.

tool
string

The MCP tool, e.g. "ask_stefanbrain". Up to 120 characters; longer text is trimmed.

error_code
string

The error code you got, e.g. "invalid_output_config". Up to 120 characters; longer text is trimmed.

request_id
string

The req_, run_, job_ or chat_ id of the call that failed. Up to 120 characters; longer text is trimmed.

agent
string

Your agent or client and its version, e.g. "Claude Code 2.1". Up to 200 characters; longer text is trimmed.

Response

The stored report, with what happens next in guidance.

One report and, once there is one, the StefanBrain team's reply.

object
string
required
Allowed value: "feedback"
id
string
required

fb_ id.

status
enum<string>
required
Available options:
open,
acknowledged,
resolved,
wont_fix
category
enum<string>
required
Available options:
bug,
docs,
confusing,
missing_feature,
performance,
other
summary
string
required
adjustments
string[]
required

What intake changed: a trimmed field, an unknown category filed as other, a redacted value.

created_at
string<date-time>
required
updated_at
string<date-time>
required
guidance
string
required

What happens next and where the reply will be.

impact
enum<string> | null
Available options:
blocked,
worked_around,
minor,
null
details
string | null
suggestion
string | null
endpoint
string | null
tool
string | null
error_code
string | null
request_id
string | null
agent
string | null
reply
string | null

The team's reply; null until there is one.

replied_at
string<date-time> | null