---
title: "Delete a scheduled agent"
method: DELETE
path: "/agent/schedules/{scheduleId}"
tags: ["schedules"]
---

# Delete a scheduled agent

`DELETE /agent/schedules/{scheduleId}`

Delete a scheduled agent. This will stop all future scheduled runs.

## Path parameters

- `scheduleId` string, required

## Response `200`

Scheduled agent deleted successfully

- DeleteScheduledAgentResponse
  - `success` boolean, required — Whether the deletion was successful

## Other responses

- `401` — Authentication required
- `403` — No permission to delete schedule
- `404` — Schedule not found
- `500` — Internal server error

---

[API](https://skmtc.dev/warp/apis/oz-agent-api.md) · [All operations](https://skmtc.dev/warp/apis/oz-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/warp/oz-agent-api/revisions/a0daf9e59774/schema)