Trigger a schedule

Trigger one fire of a schedule now, without changing its cron cadence.

POST /api/v2/schedules/{schedule_id}/trigger

Python

from hai_agents import Client

client = Client()

run = client.schedules.trigger_schedule(schedule_id)
print(run.status, run.session_id)

200

{
  "id": "3c2b1a09-8d7e-4f6a-b5c4-d3e2f1a0b9c8",
  "schedule_id": "9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f",
  "status": "created",
  "scheduled_for": "2026-07-04T11:26:03Z",
  "session_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "error": null,
  "triggered_manually": true,
  "created_at": "2026-07-04T11:26:05Z"
}

Behavior

The outcome comes back synchronously. It works while paused, and 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.

Path parameters

schedule_id · string · required

The schedule’s ID (UUID).

Response

200 with the run record for this fire, with triggered_manually: true.

Python

from hai_agents import Client

client = Client()

run = client.schedules.trigger_schedule(schedule_id)
print(run.status, run.session_id)

200

{
  "id": "3c2b1a09-8d7e-4f6a-b5c4-d3e2f1a0b9c8",
  "schedule_id": "9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f",
  "status": "created",
  "scheduled_for": "2026-07-04T11:26:03Z",
  "session_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "error": null,
  "triggered_manually": true,
  "created_at": "2026-07-04T11:26:05Z"
}

Errors

Status	Cause
404	Not found, or not in your organization.
409	A fire for this schedule is already in progress. Retry shortly (a Retry-After header is included).