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

# Trigger a schedule

> Fire a schedule once, immediately.

Fires the schedule once now and returns the outcome synchronously. Works while paused, and the regular cadence is unaffected: `next_run_times` and `last_run_at` do not change. The fire goes through the same checks as an automatic one, so it can come back `skipped_overlap` or `skipped_quota` rather than `created`.

**Returns** the [run record](/computer-use-agents/schedules/runs) for this fire, with `triggered_manually: true`.

***

## Path parameters

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

***

## Examples

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

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

  client = Client()

  run = client.schedules.trigger_schedule("9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f")
  print(run.status, run.session_id)
  ```

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

  const client = new HaiAgentsClient();

  const run = await client.schedules.triggerSchedule({ scheduleId: "9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f" });
  console.log(run.status, run.sessionId);
  ```
</CodeGroup>

```json Response theme={null}
{
  "id": "3c2b1a09-8d7e-4f6a-b5c4-d3e2f1a0b9c8",
  "schedule_id": "9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f",
  "status": "created",
  "scheduled_for": "2026-07-04T11:26:03Z",
  "session_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "error": null,
  "triggered_manually": true,
  "created_at": "2026-07-04T11:26:05Z"
}
```

***

## Errors

| Status | Cause                                                                                                |
| ------ | ---------------------------------------------------------------------------------------------------- |
| `404`  | No schedule with this id in your organization.                                                       |
| `409`  | A fire for this schedule is already in progress; retry shortly (a `Retry-After` header is included). |