---
title: "Create override"
method: POST
path: "/api/{cloudId}/v1/schedules/{scheduleId}/overrides"
tags: ["Schedule overrides"]
---

# Create override

`POST /api/{cloudId}/v1/schedules/{scheduleId}/overrides`

Creates a new override for the schedule with given id and properties.<br> <br> **Permissions required:** Permission to create an override: 
 - the user has edit configuration right. 
 - the user is a member of the team that the schedule belongs to. 
 - the user is adding override to themself. 
 - the user exists in the schedule directly or indirectly.

## Path parameters

- `scheduleId` string, required

## Request body

- CreateOverrideRequest
  - `responder` OverrideResponderInfo, required — Responder that takes on-call via the override.
    - `type` 'user' | 'noone', required — Type of the responder.
    - `id` string — ID of the responder. Null if the type is `noone`.
  - `startDate` string, date-time, required — Start time of the override.
  - `endDate` string, date-time, required — End time of the override.
  - `rotationIds` string[] — IDs of the rotations that this override is applied to. Should be null to apply override to all rotations.

## Response `201`

Returned if the override is created successfully.

- Override
  - `alias` string — Alias of the override.
  - `responder` OverrideResponderInfo — Responder that takes on-call via the override.
    - `type` 'user' | 'noone', required — Type of the responder.
    - `id` string — ID of the responder. Null if the type is `noone`.
  - `startDate` string, date-time — Start time of the override.
  - `endDate` string, date-time — End time of the override.
  - `rotationIds` string[] — IDs of the rotations that override applies to. Null if no rotation is specified during override creation.

## Other responses

- `401` — Returned if the authentication credentials are incorrect.
- `403` — Returned if the user does not have permission to create the override.
- `404` — Returned if the schedule is not found.
- `422` — Returned if the payload cannot be validated.

---

[API](https://skmtc.net/atlassian/apis/jsm-operations-api.md) · [All operations](https://skmtc.net/atlassian/apis/jsm-operations-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/jsm-operations-api/versions/ed65f017bcb8/schema)