---
title: "Reroute one or more incidents to one or more new routable destinations."
method: POST
path: "/api-public/v1/incidents/reroute"
tags: ["Incidents"]
---

# Reroute one or more incidents to one or more new routable destinations.

`POST /api-public/v1/incidents/reroute`

Reroute one or more incidents to one or more users and/or escalation policies.

The "addTargets" option converts the incident to requiring a response from each paged user
and escalation policy before paging is stopped. The option is available only to Enterprise accounts.

This API may be called a maximum of 2 times per second.

## Headers

- `X-VO-Api-Id` string, required
- `X-VO-Api-Key` string, required

## Request body

- RerouteCollection
  - `userName` string, required
  - `reroutes` Reroute[], required
    - `incidentNumber` string, required
    - `targets` IncidentTarget[], required
      - `type` 'User' | 'EscalationPolicy', required — Type of target
      - `slug` string, required — User name or escalation policy slug
    - `addTargets` boolean

## Response `200`

The created reroute object

- RerouteStatusResponse
  - `statuses` RerouteStatus[]
    - `incidentNumber` string, required
    - `success` boolean, required
    - `targetStatus` RerouteTargetStatus[], required
      - `slug` string, required — User name or escalation policy slug
      - `success` boolean, required
      - `message` string
    - `message` string

---

[API](https://skmtc.net/victorops/apis/victorops-api.md) · [All operations](https://skmtc.net/victorops/apis/victorops-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/victorops/victorops-api/revisions/7a7391256058/schema)