Skip to main content
POST
/
api
/
v2
/
schedules
/
{schedule_id}
/
trigger
Trigger a schedule
curl --request POST \
  --url https://agp.eu.hcompany.ai/api/v2/schedules/{schedule_id}/trigger \
  --header 'Authorization: Bearer <token>'
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 for this fire, with triggered_manually: true.

​
Path parameters

​
schedule_id
string
required
The schedule’s id (UUID).

​
Examples

curl -X POST "https://agp.eu.hcompany.ai/api/v2/schedules/9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f/trigger" \
  -H "Authorization: Bearer $HAI_API_KEY"
Response
{
  "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

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