POST/status/incidents

Create a status incident or maintenance window

Publishes an incident/maintenance window and (by default) notifies subscribers

Request body

Field	Type	Description
`kind`required	`"incident" \| "maintenance"`
`title`required	`string`
`status`required	`"investigating" \| "identified" \| "monitoring" \| "resolved" \| "scheduled" \| "in_progress" \| "verifying" \| "completed"`	Incident lifecycle (investigating\|identified\|monitoring\|resolved) or maintenance lifecycle (scheduled\|in_progress\|verifying\|completed), depending on `kind`.
`impact`	`"none" \| "minor" \| "major" \| "critical" \| "maintenance"`	Incident impact severity
`impactOverride`	`boolean`
`affectedComponents`required	`object[]`
`body`required	`string`	Body of the first status update
`scheduledStartAt`	`string \| null`
`scheduledEndAt`	`string \| null`
`autoStart`	`boolean`
`autoComplete`	`boolean`
`backfill`	`object`	Creates the incident already resolved, historical; never notifies
`notifySubscribers`	`boolean`

Response

Status incident created

Field	Type	Description
`id`required	`string`	TypeID - a type-prefixed UUID
`kind`required	`"incident" \| "maintenance"`
`title`required	`string`
`status`required	`"investigating" \| "identified" \| "monitoring" \| "resolved" \| "scheduled" \| "in_progress" \| "verifying" \| "completed"`	Incident lifecycle (investigating\|identified\|monitoring\|resolved) or maintenance lifecycle (scheduled\|in_progress\|verifying\|completed), depending on `kind`.
`impact`required	`"none" \| "minor" \| "major" \| "critical" \| "maintenance"`	Incident impact severity
`impactOverride`required	`boolean`
`scheduledStartAt`required	`string \| null`	ISO 8601 timestamp or null
`scheduledEndAt`required	`string \| null`	ISO 8601 timestamp or null
`autoStart`required	`boolean`
`autoComplete`required	`boolean`
`startedAt`required	`string`	ISO 8601 timestamp
`resolvedAt`required	`string \| null`	ISO 8601 timestamp or null
`backfilled`required	`boolean`
`notifiedAt`required	`string \| null`	ISO 8601 timestamp or null
`createdBy`required	`string \| null`
`createdAt`required	`string`	ISO 8601 timestamp
`updatedAt`required	`string`	ISO 8601 timestamp
`affectedComponents`required	`object[]`
`updates`required	`object[]`

Errors

400Validation error

401Unauthorized

Example request

curl \
  -X POST \
  "https://feedback.quackback.io/api/v1/status/incidents" \
  -H "Authorization: Bearer qb_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "example_kind",
  "title": "example_title",
  "status": "example_status",
  "impact": "example_impact",
  "impactOverride": false,
  "affectedComponents": [],
  "body": "example_body",
  "autoStart": false,
  "autoComplete": false,
  "notifySubscribers": false
}'