hog_flows

Fire a schedule-triggered workflow immediately, outside its regular schedule.

Restricted to the schedule trigger type: batch/webhook/etc. triggers have their own dedicated entry points (batch_jobs, the public webhook URL) with trigger-specific guardrails this endpoint doesn't replicate. Requires the workflow to be active, same gate the scheduler itself applies in internal_process_due_schedules.

Send an Idempotency-Key header to dedupe retries (a double-click, or a client retry after a timed-out request): a repeat with the same key returns the first call's result instead of firing a second AI task. Without the header, every call fires a new run.

post/api/projects/{project_id}/hog_flows/{id}/run/

Request

  • Base URL: https://us.posthog.com
  • URL: https://us.posthog.com/api/projects/{project_id}/hog_flows/{id}/run/
  • Auth: HTTP bearer

Path parameters

idstring uuid required

A UUID string identifying this hog flow.

project_idstring required

Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.

Request body

variablesobject

Variable value overrides, merged with the workflow's own variable defaults for this run only.

Response

statusstring required

'queued' once the invocation has been queued for execution.

invocation_idstring required

ID of the queued hog flow invocation.

Changes

No recorded changes to this operation across all 1 revision of this API.