GEgetorchestra
Incidents

Merge incidents

Changed on

Merge the incidents named in the request body into the incident in the path. Merging is one level deep - merging an incident that already has a parent, or naming one that has incidents merged into it, is rejected rather than nesting further.

agentSessionId is optional, and only Orchestra agent sessions should set it. When set, the merge is attributed to Orchestra AI and linked to that session, and the session may only merge the incident it was started for, into an older incident.

post/incidents/{incident_id}/merge

Request

  • Base URL
    https://app.getorchestra.io/api/engine/public
  • URL
    https://app.getorchestra.io/api/engine/public/incidents/{incident_id}/merge
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://app.getorchestra.io/oauth/authorize
      Token URL: https://app.getorchestra.io/oauth/token scopes: orchestra:write

Path parameters

incident_idstring uuid4 required

Incident ID to merge the named incidents into.

Headers

X-Orchestra-Account-Idstring uuid4 nullable

Act on this account rather than the one the credential resolves to. Omit it to use the credential's own account. An API key is issued to a single account, so it may only name that account; an OAuth token may name any account its grant covers.

Request body

incidentIdsstring[] required

Response

Successful Response

incidentIdstring uuid4 required
status'DISMISSED' | 'INVESTIGATING' | 'OPEN' | 'RESOLVED' required
severity'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW' required
namestring nullable
descriptionstring nullable
assigneestring nullable
subscribersstring[]
parentIncidentIdstring uuid4 nullable
createdAtstring required
updatedAtstring required
resolvedAtstring nullable
resolvedBystring uuid4 nullable
resolvedByType'AI' | 'API' | 'OTHER' | 'SYSTEM' | 'USER'
archivedAtstring nullable
mutedAtstring nullable
isMutedboolean
mutedUntilstring nullable
monitorIdstring uuid4 nullable
eventCountinteger required
childCountinteger required

Changes