---
title: "Delete rotation schedule"
method: DELETE
path: "/rotationschedules/{id}"
tags: ["Rotation Schedules"]
---

# Delete rotation schedule

`DELETE /rotationschedules/{id}`

## Request

- Base URL: `https://api.getmaintainx.com/v1`
- URL: `https://api.getmaintainx.com/v1/rotationschedules/{id}`
- Auth: HTTP bearer

Deletes a rotation schedule and unassigns every user currently assigned to it. This is a soft delete: the rotation stops being returned by the read endpoints and cannot be restored through the REST API. Deleting an already deleted rotation is a no-op. The default rotation cannot be deleted.

## Path parameters

- `id` integer, required

## Query parameters

- `skipWebhook` boolean

## Response `204`

Successfully deleted the rotationSchedule

## Other responses

- `400`: The default rotation cannot be deleted
- `401`: Invalid token
- `403`: The caller cannot delete this rotation schedule
- `404`: Could not find the specified rotationSchedule.
- `500`: Internal server error.

## Changes

> 30 revisions in range; 1 not diffed.

- **2026-10-16** `08b21e946629`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getmaintainx/apis/maintainx-api/changes/rotationschedules/:id/delete.md)

---

[API](https://skmtc.dev/getmaintainx/apis/maintainx-api.md) - [All operations](https://skmtc.dev/getmaintainx/apis/maintainx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getmaintainx/apis/maintainx-api/revisions/6258367c04ff?raw)