> ## 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.

# Pause a schedule

> Stop future fires without deleting the schedule.

Pauses the schedule: automatic fires stop and `next_run_times` empties. The schedule can still be fired manually with [Trigger](/computer-use-agents/schedules/trigger).

**Returns** the updated [schedule object](/computer-use-agents/schedules/retrieve) with `paused: true`.

***

## Path parameters

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

## Request body

<ParamField body="note" type="string">
  Optional note explaining why the schedule is paused (max 255 characters). Returned as `pause_note`.
</ParamField>

***

## Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://agp.eu.hcompany.ai/api/v2/schedules/9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f/pause" \
    -H "Authorization: Bearer $HAI_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"note": "Paused during site maintenance"}'
  ```

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

  client = Client()

  schedule = client.schedules.pause_schedule(
      "9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f",
      request=PauseSchedule(note="Paused during site maintenance"),
  )
  print(schedule.paused, schedule.pause_note)
  ```

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

  const client = new HaiAgentsClient();

  const schedule = await client.schedules.pauseSchedule({
    scheduleId: "9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f",
    body: { note: "Paused during site maintenance" },
  });
  console.log(schedule.paused, schedule.pauseNote);
  ```
</CodeGroup>

***

## Errors

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