--- title: "Merge incidents" method: POST path: "/incidents/{incident_id}/merge" tags: ["Incidents"] --- # Merge incidents `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: one of: - HTTP bearer - OAuth 2 - Authorization code: `https://app.getorchestra.io/oauth/authorize` - Token URL: `https://app.getorchestra.io/oauth/token` scopes: `orchestra:write` 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. ## Path parameters - `incident_id` string, uuid4, required ## Headers - `X-Orchestra-Account-Id` string, uuid4, nullable ## Request body - MergeIncidentsRequest: The incidents to merge into, or detach from, the incident named in the path. Capped low: every incident listed is locked for the length of the write, and grouping is a judgement someone makes about a handful of incidents they have actually read, not a bulk operation. A caller with more to move can send another request. - `incidentIds` string[], required ## Response `200` Successful Response - IncidentDetailResponse: A single incident, with the counts the detail page shows in its header. - `incidentId` string, uuid4, required - `status` 'DISMISSED' | 'INVESTIGATING' | 'OPEN' | 'RESOLVED', required - `severity` 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW', required - `name` string, nullable - `description` string, nullable - `assignee` string, nullable - `subscribers` string[] - `parentIncidentId` string, uuid4, nullable - `createdAt` string, required - `updatedAt` string, required - `resolvedAt` string, nullable - `resolvedBy` string, uuid4, nullable - `resolvedByType` 'AI' | 'API' | 'OTHER' | 'SYSTEM' | 'USER' - `archivedAt` string, nullable - `mutedAt` string, nullable - `isMuted` boolean - `mutedUntil` string, nullable - `monitorId` string, uuid4, nullable - `children` IncidentResponse[] - `incidentId` string, uuid4, required - `status` 'DISMISSED' | 'INVESTIGATING' | 'OPEN' | 'RESOLVED', required - `severity` 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW', required - `name` string, nullable - `description` string, nullable - `assignee` string, nullable - `subscribers` string[] - `parentIncidentId` string, uuid4, nullable - `createdAt` string, required - `updatedAt` string, required - `resolvedAt` string, nullable - `resolvedBy` string, uuid4, nullable - `resolvedByType` 'AI' | 'API' | 'OTHER' | 'SYSTEM' | 'USER' - `archivedAt` string, nullable - `mutedAt` string, nullable - `isMuted` boolean - `mutedUntil` string, nullable - `monitorId` string, uuid4, nullable - `children` IncidentResponse[] - `eventCount` integer, required - `childCount` integer, required - `relatedResources` IncidentRelatedResourceResponse[] - `resourceType` 'ASSET' | 'EXTERNAL' | 'OPERATION' | 'PIPELINE' | 'SENSOR' | 'TASK', required - `resourceId` string, uuid4, required - `name` string, required - `firstSeenAt` string, required - `parentPipelineRunId` string, uuid4, nullable - `parentTaskRunId` string, uuid4, nullable - `storesTaskRunLogs` boolean - `integration` 'AIRBYTE_CLOUD' | 'AIRBYTE_SERVER' | 'AIRFLOW' | 'ARCH' | 'ALTERYX_SERVER' | 'ANTHROPIC' | 'AWS_EC2' | 'AWS_ECS' | 'AWS_EMR' | 'AWS_EKS' | 'AWS_FIREHOSE' | 'AWS_GLUE' | 'AWS_LAMBDA' | 'AWS_RDS' | 'AWS_REDSHIFT' | 'AWS_S3' | 'AWS_BATCH' | 'AWS_BEDROCK' | 'AWS_SAGEMAKER' | 'AWS_SECRETS_MANAGER' | 'AWS_SES' | 'AWS_STEP_FUNCTIONS' | 'AZURE' | 'AZURE_CONTAINER_APPS' | 'AZURE_DATA_FACTORY' | 'AZURE_DATA_LAKE_STORAGE' | 'AZURE_KEY_VAULT' | 'AZURE_KUBERNETES_SERVICE' | 'AZURE_LOGIC_APPS' | 'AZURE_SYNAPSE_ANALYTICS' | 'AZURE_VM' | 'BAUPLAN' | 'BOOMI' | 'CDATA' | 'CENSUS' | 'CLICKHOUSE' | 'COALESCE' | 'COUNT' | 'DATADOG' | 'DATABRICKS' | 'DATAPROC' | 'DATAZEN' | 'DBT' | 'DBT_CORE' | 'DLT' | 'DOMO' | 'DREMIO' | 'DUCKDB' | 'EMAIL' | 'ESTUARY' | 'ETLEAP' | 'FABRIC' | 'FABRIC_SYNAPSE' | 'FIVETRAN' | 'FORTRA' | 'GCP_BIG_QUERY' | 'GCP_CLOUD_RUN' | 'GCP_CLOUD_FUNCTIONS' | 'GCP_CLOUD_STORAGE' | 'GCP_DATAFLOW' | 'GCP_DATAFORM' | 'GCP_DATASTREAM' | 'GCP_LOOKER' | 'GKE' | 'GITHUB_ACTIONS' | 'GOOGLE_CLOUD' | 'HEVO' | 'HEX' | 'HIGHTOUCH' | 'HTTP' | 'HUBSPOT' | 'INFORMATICA_IICS' | 'INFORMATICA_POWERCENTER' | 'KAFKA' | 'KEBOOLA' | 'KLEENE' | 'LIGHTDASH' | 'LINUX_SSH' | 'MARIADB' | 'MATILLION' | 'MATILLION_ETL' | 'METAPLANE' | 'MICROSOFT_TEAMS' | 'MICROSTRATEGY' | 'MONGODB' | 'MOTHERDUCK' | 'MYSQL' | 'N8N' | 'NIMBLE' | 'NOTION' | 'OMNI' | 'OPEN_AI' | 'ORCHESTRA' | 'PARADIME' | 'PAGER_DUTY' | 'PINECONE' | 'PORTABLE' | 'POSTGRES' | 'POWER_AUTOMATE' | 'POWER_BI' | 'PREFECT_CLOUD' | 'PYTHON' | 'QLIK' | 'QLIK_REPLICATE' | 'QUICKBOOKS' | 'RENDER' | 'RIVERY' | 'RUDDERSTACK' | 'SALESFORCE' | 'SAP' | 'SFTP' | 'SHAREPOINT' | 'SIGMA' | 'SISENSE' | 'SLACK' | 'SNOWFLAKE' | 'SNOWPLOW' | 'SODA' | 'SQL_MESH' | 'SQL_SERVER' | 'STITCH' | 'STREAMKAP' | 'TABLEAU_CLOUD' | 'TALEND_CLOUD' | 'THOUGHTSPOT' | 'TOBIKO_CLOUD' | 'TYPESAFE' | 'WEAVIATE' | 'WEBHOOK' | 'WELD' | 'WINDOWS_SSH' - `assetIntegrationAccountId` string, nullable - `assetType` 'CHART' | 'DASHBOARD' | 'DASHBOARD_VIEWS' | 'DATASET' | 'QUERIES' | 'TABLE' | 'UNKNOWN' | 'VIEW' | 'WORKBOOK' - `assetDatabaseName` string, nullable - `assetSchemaName` string, nullable - `assetWorkspaceId` string, nullable - `assetWorkspaceName` string, nullable - `alertThreads` IncidentAlertThreadResponse[] - `integration` 'AIRBYTE_CLOUD' | 'AIRBYTE_SERVER' | 'AIRFLOW' | 'ARCH' | 'ALTERYX_SERVER' | 'ANTHROPIC' | 'AWS_EC2' | 'AWS_ECS' | 'AWS_EMR' | 'AWS_EKS' | 'AWS_FIREHOSE' | 'AWS_GLUE' | 'AWS_LAMBDA' | 'AWS_RDS' | 'AWS_REDSHIFT' | 'AWS_S3' | 'AWS_BATCH' | 'AWS_BEDROCK' | 'AWS_SAGEMAKER' | 'AWS_SECRETS_MANAGER' | 'AWS_SES' | 'AWS_STEP_FUNCTIONS' | 'AZURE' | 'AZURE_CONTAINER_APPS' | 'AZURE_DATA_FACTORY' | 'AZURE_DATA_LAKE_STORAGE' | 'AZURE_KEY_VAULT' | 'AZURE_KUBERNETES_SERVICE' | 'AZURE_LOGIC_APPS' | 'AZURE_SYNAPSE_ANALYTICS' | 'AZURE_VM' | 'BAUPLAN' | 'BOOMI' | 'CDATA' | 'CENSUS' | 'CLICKHOUSE' | 'COALESCE' | 'COUNT' | 'DATADOG' | 'DATABRICKS' | 'DATAPROC' | 'DATAZEN' | 'DBT' | 'DBT_CORE' | 'DLT' | 'DOMO' | 'DREMIO' | 'DUCKDB' | 'EMAIL' | 'ESTUARY' | 'ETLEAP' | 'FABRIC' | 'FABRIC_SYNAPSE' | 'FIVETRAN' | 'FORTRA' | 'GCP_BIG_QUERY' | 'GCP_CLOUD_RUN' | 'GCP_CLOUD_FUNCTIONS' | 'GCP_CLOUD_STORAGE' | 'GCP_DATAFLOW' | 'GCP_DATAFORM' | 'GCP_DATASTREAM' | 'GCP_LOOKER' | 'GKE' | 'GITHUB_ACTIONS' | 'GOOGLE_CLOUD' | 'HEVO' | 'HEX' | 'HIGHTOUCH' | 'HTTP' | 'HUBSPOT' | 'INFORMATICA_IICS' | 'INFORMATICA_POWERCENTER' | 'KAFKA' | 'KEBOOLA' | 'KLEENE' | 'LIGHTDASH' | 'LINUX_SSH' | 'MARIADB' | 'MATILLION' | 'MATILLION_ETL' | 'METAPLANE' | 'MICROSOFT_TEAMS' | 'MICROSTRATEGY' | 'MONGODB' | 'MOTHERDUCK' | 'MYSQL' | 'N8N' | 'NIMBLE' | 'NOTION' | 'OMNI' | 'OPEN_AI' | 'ORCHESTRA' | 'PARADIME' | 'PAGER_DUTY' | 'PINECONE' | 'PORTABLE' | 'POSTGRES' | 'POWER_AUTOMATE' | 'POWER_BI' | 'PREFECT_CLOUD' | 'PYTHON' | 'QLIK' | 'QLIK_REPLICATE' | 'QUICKBOOKS' | 'RENDER' | 'RIVERY' | 'RUDDERSTACK' | 'SALESFORCE' | 'SAP' | 'SFTP' | 'SHAREPOINT' | 'SIGMA' | 'SISENSE' | 'SLACK' | 'SNOWFLAKE' | 'SNOWPLOW' | 'SODA' | 'SQL_MESH' | 'SQL_SERVER' | 'STITCH' | 'STREAMKAP' | 'TABLEAU_CLOUD' | 'TALEND_CLOUD' | 'THOUGHTSPOT' | 'TOBIKO_CLOUD' | 'TYPESAFE' | 'WEAVIATE' | 'WEBHOOK' | 'WELD' | 'WINDOWS_SSH', required - `channelName` string, required - `url` string, required ## Other responses - `422`: Validation Error ## Changes - **2026-11-03** `e45165e7e223`: 1 info - endpoint added [Operation history](https://skmtc.dev/getorchestra/apis/orchestra-api/changes/incidents/:incident_id/merge/post.md) --- [API](https://skmtc.dev/getorchestra/apis/orchestra-api.md) - [All operations](https://skmtc.dev/getorchestra/apis/orchestra-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getorchestra/apis/orchestra-api/revisions/daf2c16b3057?raw)