---
title: "Reroute On-Call Page"
method: POST
path: "/api/v2/on-call/pages/{page_id}/reroute"
tags: ["On-Call Paging"]
---

# Reroute On-Call Page

`POST /api/v2/on-call/pages/{page_id}/reroute`

## Request

- Base URL: `https://navy.oncall.datadoghq.com`
- URL: `https://navy.oncall.datadoghq.com/api/v2/on-call/pages/{page_id}/reroute`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token`
- TypeScript: <https://skmtc.dev/datadog/apis/datadog-api-v2-collection/docs/api/v2/on-call/pages/:page_id/reroute/post.ts> (a function with typed inputs; its response is checked against the schema)

Reroutes an On-Call Page.

## Path parameters

- `page_id` string, uuid, required

## Request body

- RerouteOnCallPageRequest: Full request to reroute an On-Call Page to a different team or user.
  - `data` RerouteOnCallPageRequestData, required: The data for rerouting an On-Call Page, including attributes and resource type.
    - `attributes` RerouteOnCallPageRequestDataAttributes, required: Details about where to reroute the On-Call Page.
      - `comment` string: An optional comment explaining why the page is being rerouted.
      - `target` CreatePageRequestDataAttributesTarget, required: Information about the target to notify (such as a team or user).
        - `identifier` string: Identifier for the target (for example, team handle or user ID).
        - `type` 'team_id' | 'team_handle' | 'user_id': The kind of target, `team_id` | `team_handle` | `user_id`.
    - `type` 'reroute', required: The type of resource used when rerouting an On-Call Page.

## Response `204`

No Content.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/3f70db624329?raw)