---
search:
  tags:
    - Schedules
    - DELETE
seo:
  description: >-
    Destructive. A DELETE without the body { confirm: true } answers 400…
    Reference for the DELETE /schedules/{schedule_id} endpoint in the Zaraftis
    Public API.
sidebar:
  label: Delete a schedule
  badge: DELETE
title: Delete a schedule
type: openapi-operation
---
Destructive. A DELETE without the body { confirm: true } answers 400 confirmation_required with the consequences and the re-send form. With confirm the schedule record is removed, all future scheduled scans stop, and the setup stays usable for manual scans (historical scans keep their own records and billing).

`DELETE /schedules/{schedule_id}`

**Request body** (`application/json`, required)

- `confirm` (boolean, required)

Request body example:

```json
{
  "confirm": true
}
```

**Responses**

- `200` — The removed schedule reference
- `400` — bad\_request or validation\_failed
- `404` — not\_found: unknown id, or an id this key cannot see