Hog
For instructions on how to authenticate to use this endpoint, see API overview.
Endpoints
GET | |
PATCH | |
DELETE | |
GET | |
POST | |
POST | |
GET | |
GET | |
GET | |
GET | |
POST | |
PATCH | |
DELETE | |
POST | |
POST |
Retrieve hog flows
Required API key scopes
hog_flow:readPath parameters
- idstring
Response
Example request
GET /api /projects /:project_id /hog_flows /:idExample response
Status 200
RESPONSE
Update hog flows
Required API key scopes
hog_flow:writePath parameters
- idstring
Request parameters
- namestringnull
- descriptionstring
- status
- trigger
- trigger_masking
- conversion
- exit_condition
- edges
- actionsarray
- variablesarray
Response
Example request
PATCH /api /projects /:project_id /hog_flows /:idExample response
Status 200
RESPONSE
Delete hog flows
Required API key scopes
hog_flow:writePath parameters
- idstring
Example request
DELETE /api /projects /:project_id /hog_flows /:idExample response
Status 204 No response body
Retrieve hog flows batch jobs
Path parameters
- idstring
Response
Example request
GET /api /projects /:project_id /hog_flows /:id /batch_jobsExample response
Status 200
RESPONSE
Create hog flows batch jobs
Path parameters
- idstring
Request parameters
- namestringnull
- descriptionstring
- status
- trigger
- trigger_masking
- conversion
- exit_condition
- edges
- actionsarray
- variablesarray
Response
Example request
POST /api /projects /:project_id /hog_flows /:id /batch_jobsExample response
Status 200
RESPONSE
Create hog flows invocations
Path parameters
- idstring
Request parameters
- namestringnull
- descriptionstring
- status
- trigger
- trigger_masking
- conversion
- exit_condition
- edges
- actionsarray
- variablesarray
Response
Example request
POST /api /projects /:project_id /hog_flows /:id /invocationsExample response
Status 200
RESPONSE
Retrieve hog flows logs
Also available via the PostHog MCP server:
hog-flows-logs-retrieve— Get workflow logs
Required API key scopes
hog_flow:readPath parameters
- idstring
Query parameters
- afterstring
- beforestring
- instance_idstring
- levelstring
- limitintegerDefault:
50 - searchstring
Example request
GET /api /projects /:project_id /hog_flows /:id /logsExample response
Status 200 No response body
Retrieve hog flows metrics
Also available via the PostHog MCP server:
hog-flows-metrics-retrieve— Get workflow metrics
Required API key scopes
hog_flow:readPath parameters
- idstring
Query parameters
- afterstringDefault:
-7d - beforestring
- breakdown_bystringDefault:
kindOne of:"name""kind" - instance_idstring
- intervalstringDefault:
dayOne of:"hour""day""week" - kindstring
- namestring
Response
Example request
GET /api /projects /:project_id /hog_flows /:id /metricsExample response
Status 200
RESPONSE
Retrieve hog flows metrics totals
Required API key scopes
hog_flow:readPath parameters
- idstring
Query parameters
- afterstringDefault:
-7d - beforestring
- breakdown_bystringDefault:
kindOne of:"name""kind" - instance_idstring
- intervalstringDefault:
dayOne of:"hour""day""week" - kindstring
- namestring
Response
Example request
GET /api /projects /:project_id /hog_flows /:id /metrics /totalsExample response
Status 200
RESPONSE
List all hog flows schedules
Path parameters
- idstring
Query parameters
- created_atstring
- created_byinteger
- idstring
- limitinteger
- offsetinteger
- updated_atstring
Response
Example request
GET /api /projects /:project_id /hog_flows /:id /schedulesExample response
Status 200
RESPONSE
Create hog flows schedules
Path parameters
- idstring
Query parameters
- created_atstring
- created_byinteger
- idstring
- limitinteger
- offsetinteger
- updated_atstring
Request parameters
- namestringnull
- descriptionstring
- status
- trigger
- trigger_masking
- conversion
- exit_condition
- edges
- actionsarray
- variablesarray
Response
Example request
POST /api /projects /:project_id /hog_flows /:id /schedulesExample response
Status 200
RESPONSE
Update hog flows schedules
Path parameters
- idstring
- schedule_idstring
Request parameters
- namestringnull
- descriptionstring
- status
- trigger
- trigger_masking
- conversion
- exit_condition
- edges
- actionsarray
- variablesarray
Response
Example request
PATCH /api /projects /:project_id /hog_flows /:id /schedules /:schedule_idExample response
Status 200
RESPONSE
Delete hog flows schedules
Path parameters
- idstring
- schedule_idstring
Example request
DELETE /api /projects /:project_id /hog_flows /:id /schedules /:schedule_idExample response
Status 204 No response body
Create hog flows bulk delete
Request parameters
- namestringnull
- descriptionstring
- status
- trigger
- trigger_masking
- conversion
- exit_condition
- edges
- actionsarray
- variablesarray
Response
Example request
POST /api /projects /:project_id /hog_flows /bulk_deleteExample response
Status 200
RESPONSE
Create hog flows user blast radius
Request parameters
- filtersobject
- group_type_indexintegernull
Response
Example request
POST /api /projects /:project_id /hog_flows /user_blast_radiusExample response
Status 200
RESPONSE