Skip to main content

Update an incident (status / priority / assignee / comment)

PATCH 
/v2/incidents/:id

Applies partial updates to a single incident identified by its Display ID (XVA-<number>).

  • status: client-facing status label. If the transition requires a comment and none is supplied, a fallback comment is auto-generated and attributed to the integration source.
  • priority: P0, P1 or P2, the same vocabulary the read APIs return, so a value read from an alert can be written back without mapping. Case-sensitive exact match.
  • assignee_email: email of the new assignee, or null to unassign. Same semantics as the dedicated /assignee route, for playbooks that combine acknowledge-and-assign in one call.
  • comment: free-text comment attached to the incident.
  • external_reference: optional { system, ticket_id, url } passed through to the changelog for correlation with your ticketing system.

Idempotent: an identical body against an unchanged incident returns a no-op success.

Request​

Responses​

Update applied. data contains the post-update incident snapshot.