> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runtm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Scheduled Agent

> Permanently delete a scheduled agent and its schedule

Deletes the agent and best-effort removes its Cloud Scheduler job, returning `204`. To pause a schedule while keeping its configuration, use [Update](https://docs.runtm.com/cloud-api/scheduled-agents/update.md) with `"enabled": false` instead.

**Required scope:** `sessions:write` and an admin or owner role.

## Path Parameters

**agent\_id** `string` *required*

The scheduled agent ID.

```bash cURL theme={null}
curl -X DELETE "https://app.runtm.com/api/cloud/v1/scheduled-agents/sa_9f3c1a" \
  -H "Authorization: Bearer runtm_xxx" \
  -H "X-Organization-Id: org_abc123"
```

```bash CLI theme={null}
runtm-api scheduled-agents delete sa_9f3c1a --yes
```

```json 204 theme={null}
{}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.