---
title: "CreateOverride Schedules V2"
method: POST
path: "/v2/schedule_overrides"
tags: ["Schedules V2"]
---

# CreateOverride Schedules V2

`POST /v2/schedule_overrides`

Create a new schedule override.

## Request body

- SchedulesV2CreateOverrideRequestBody
  - `end_at` string, date-time, required — End time of the override
  - `layer_id` string, required — The layer this override applies to
  - `rotation_id` string, required — The rotation this override applies to
  - `schedule_id` string, required — The schedule this override applies to
  - `start_at` string, date-time, required — Start time of the override
  - `user` UserReferencePayloadV2, required
    - `email` string — The user's email address, matching the email on their Slack account
    - `id` string — The incident.io ID of a user
    - `slack_user_id` string — The ID of the user's Slack account.

## Response `201`

Created response.

- SchedulesV2CreateOverrideResponseBody
  - `override` ScheduleOverrideV2, required
    - `created_at` string, date-time, required
    - `end_at` string, date-time, required — End of the override
    - `id` string, required — Unique internal ID of the schedule override
    - `layer_id` string, required — The layer on the rotation on the schedule that this override applies to
    - `rotation_id` string, required — The rotation on the schedule that this override applies to
    - `schedule_id` string, required — The schedule that this override applies to
    - `start_at` string, date-time, required — Start of the override
    - `updated_at` string, date-time, required
    - `user` UserV2
      - `email` string — Email address of the user.
      - `id` string, required — Unique identifier of the user
      - `name` string, required — Name of the user
      - `role` 'viewer' | 'responder' | 'administrator' | 'owner' | 'unset', required — DEPRECATED: Role of the user as of March 9th 2023, this value is no longer updated.
      - `slack_user_id` string — Slack ID of the user

---

[API](https://skmtc.net/incident/apis/incident-io.md) · [All operations](https://skmtc.net/incident/apis/incident-io/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/incident/incident-io/revisions/602fc25ddd76/schema)