Skip to main content
POST
Create a manual incident

Authorizations

Authorization
string
header
required

Sent as Authorization: Bearer <token>. Three kinds are accepted: an ORG token (sv_…), bound to one workspace with a fixed role; a PERSONAL token (svu_…), which acts as you with your own live role in whichever workspace it is pointed at; and an OAUTH access token (mcp_at_…) from a connected app, limited to the workspaces you granted it. A personal or OAuth token names its workspace with the X-Sentivel-Workspace header (a slug or an id). Without it an OAuth token falls back to the connection's primary workspace, while a personal token in more than one workspace is rejected 400 invalid_request with the choices in error.details.workspaces. Membership is re-read every request, so leaving a workspace or revoking the grant takes effect at once.

Headers

Idempotency-Key
string

Opt-in safe retries. Send a unique value (a UUID); a retry with the same key replays the first response (header Idempotent-Replayed: true) instead of acting twice. Reusing a key with a different body is rejected (400); a retry while the first is in flight gets 409. Scoped to the workspace, expires after 24h.

Maximum string length: 255

Body

application/json
title
string
required
Required string length: 1 - 200
impact
enum<string>
default:minor
Available options:
minor,
major,
critical
body
string

Optional first update body.

Maximum string length: 5000

Response

The created incident.

data
object