Create an issue

Create an issue in a project, returning an existing open issue when root-cause deduplication finds a match.

post/issues

Request body

projectIdstring uuid

Project to create the issue in. Auto-filled from CLI and SDK context when omitted.

namestring

Stable issue name for indexing and mute matching. When omitted, the name is derived from contentMdx.

contentMdxstring

Safe Sazabi MDX document for the issue body (impact, root cause, remediation, evidence). Required unless sample is true.

severity'low' | 'medium' | 'high' | 'critical'

Issue severity used for prioritization and triage.

componentIdstring uuid

UUID of a registered component this issue belongs to. Required unless sample is true: every issue must be attributed to a component. List components first and pick the best match; register one if none fits. Missing or unknown IDs are rejected.

statusStartedAtstring date-time

Optional ISO timestamp for when the linked status-page incident began.

sampleboolean

When true, creates (or returns) the organization's onboarding sample issue for the target project using the curated sample payload, and the alert rides the normal issue_triggered broadcast to the configured delivery rules. Mutually exclusive with the content inputs (name, contentMdx, severity, componentId, statusStartedAt); projectId stays allowed. Idempotent per project: an existing sample attempt's issue is returned instead of creating a new one. Requires a user credential.

Response

duplicateIssueIdstring uuid

Present when creation reused an existing open issue instead of creating a new one.

Changes

No recorded changes to this endpoint across all 4 revisions of this API.