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

# Delete a schedule

> Remove a schedule and stop future fires.

Deletes the schedule and its run history. Future fires stop; sessions already created by past fires keep running.

**Returns** `204` with no body.

***

## Path parameters

<ParamField path="schedule_id" type="string" required>
  The schedule's id (UUID).
</ParamField>

***

## Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X DELETE "https://agp.eu.hcompany.ai/api/v2/schedules/9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f" \
    -H "Authorization: Bearer $HAI_API_KEY"
  ```

  ```python Python theme={null}
  from hai_agents import Client

  client = Client()

  client.schedules.delete_schedule("9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f")
  ```

  ```typescript TypeScript theme={null}
  import { HaiAgentsClient } from "hai-agents";

  const client = new HaiAgentsClient();

  await client.schedules.deleteSchedule({ scheduleId: "9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f" });
  ```
</CodeGroup>

***

## Errors

| Status | Cause                                          |
| ------ | ---------------------------------------------- |
| `404`  | No schedule with this id in your organization. |