---
title: "Delete a schedule without deleting its run receipts."
method: DELETE
path: "/v1/scheduled-scans/{scheduleId}"
tags: ["Scheduled scans"]
---

# Delete a schedule without deleting its run receipts.

`DELETE /v1/scheduled-scans/{scheduleId}`

## Request

- Base URL: `https://api.on-page.ai`
- URL: `https://api.on-page.ai/v1/scheduled-scans/{scheduleId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/on-page/apis/on-page-ai-api/docs/v1/scheduled-scans/:scheduleId/delete.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `scheduleId` string, required

## Response `204`

Schedule deleted.

## Other responses

- `401`: Unauthorized
- `403`: Scope forbidden
- `404`: Schedule not found
- `429`: Too many requests. Body is a `oneOf` of rate-limit / org-active-limit / org-queued-limit / scan-queue-saturated variants — branch on `error.code`. `Retry-After` is present when the limiter emits it; `X-RateLimit-*` is present on rate-limit-middleware 429s; `X-Concurrency-*` is present on concurrency-limit 429s (ORG_ACTIVE_LIMIT_REACHED / ORG_QUEUED_LIMIT_REACHED).
- `500`: Internal error
- `503`: Scheduled scans are disabled in this environment.

---

[API](https://skmtc.dev/on-page/apis/on-page-ai-api.md) - [All operations](https://skmtc.dev/on-page/apis/on-page-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/on-page/apis/on-page-ai-api/revisions/a081e8701c19?raw)