bugs

File a new bug

Create a bug in the API key owner's organization. source is forced to "mcp" server-side; user_id / organization_id / bug_id are derived from the API key (callers cannot override).

post/v1/bugs

Headers

x-api-keystring

Request body

summarystring required

stepsstring

status'open' | 'in_progress' | 'fixed' | 'wont_fix'

app_file_idstring uuid nullable

UUID of an uploaded app build in the caller's organization. 404 if not found or cross-org. Accepts any UUID version — Postgres' uuid column does too, and gen_random_uuid() happens to produce v4 but we don't want the API enforcing an implementation detail of the underlying RNG.

test_case_idstring nullable

Written into metadata.test_case_id for downstream attribution.

test_run_idstring nullable

Written into metadata.test_run_id for downstream attribution.

failure_classification'app_bug' | 'setup_issue'

Classifies the issue as an app bug or setup issue.

metadataobject nullable

Response

Successful Response

object required

Changes

No recorded changes to this endpoint across all 1 revision of this API.