---
title: "Cancel a schedule"
method: POST
path: "/v1/schedules/{id}/cancel"
tags: ["Schedules"]
---

# Cancel a schedule

`POST /v1/schedules/{id}/cancel`

## Request

- Base URL: `https://www.chatrail.dev`
- URL: `https://www.chatrail.dev/v1/schedules/{id}/cancel`
- Auth: HTTP bearer

Permanent. A cancelled schedule cannot be restarted.

## Path parameters

- `id` string, required

## Response `200`

The updated schedule.

## Other responses

- `409`: Not in a state that allows it.

---

[API](https://skmtc.dev/chatrail/apis/chatrail-api.md) · [All operations](https://skmtc.dev/chatrail/apis/chatrail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatrail/apis/chatrail-api/revisions/acc5b88c6f59?raw)