---
title: "Creates a new scheduled override"
method: POST
path: "/api-public/v1/overrides"
tags: ["Scheduled Overrides"]
---

# Creates a new scheduled override

`POST /api-public/v1/overrides`

Creates a new scheduled override. Start and end dates are in ISO8601 format. E.g. `2018-09-28'T'05:00:00Z`

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

- ScheduledOverridePayload
  - `username` string
  - `timezone` string
  - `start` string — The override start time (ISO 8601)
  - `end` string — The override end time (ISO 8601)

## Response `200`

The created scheduled override

- object
  - `schedule` ScheduledOverride
    - `publicId` string
    - `user` ScheduledUser
      - `username` string
      - `firstName` string
      - `lastName` string
    - `timezone` string
    - `start` string — The override start time (ISO 8601).
    - `end` string — The override end time (ISO 8601)
    - `assignments` Assignment[]
      - `_selfUrl` string
      - `team` string
      - `policy` string
      - `assigned` boolean
      - `user` string
  - `_selfUrl` string

## Other responses

- `400` — Problem with the request arguments. The response payload may include an error message.
- `401` — Authentication parameters missing
- `403` — Authentication failed or rate-limit reached
- `404` — Path not found
- `422` — You have reached your user limit.
- `500` — Internal Server Error

---

[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)