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).

severity and severityJustification are read-only: a top-level severity is ignored, and severity, severity_source and severity_justification keys in metadata are dropped.

post/v1/bugs

Request

Base URL
https://api.qualgent.ai
Auth
API key in header x-api-key
TypeScript
https://skmtc.dev/qualgent/apis/qualgent-api-service/docs/v1/bugs/post.ts
A function with typed inputs. Its response is checked against the schema.

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 operation across all 3 revisions of this API.