PostHog API — hog_flows

naftiko: 1.0.0-alpha2
info:
  label: PostHog API — hog_flows
  description: 'PostHog API — hog_flows. 42 operations. Lead operation: hog_flows. Self-contained Naftiko capability covering
    one Posthog business surface.'
  tags:
  - Posthog
  - hog_flows
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    POSTHOG_API_KEY: POSTHOG_API_KEY
capability:
  consumes:
  - type: http
    namespace: posthog-hog-flows
    baseUri: ''
    description: PostHog API — hog_flows business capability. Self-contained, no shared references.
    resources:
    - name: api-environments-environment_id-hog_flows
      path: /api/environments/{environment_id}/hog_flows/
      operations:
      - name: environmentshogflowslist
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: created_at
          in: query
          type: string
        - name: created_by
          in: query
          type: integer
        - name: id
          in: query
          type: string
        - name: limit
          in: query
          type: integer
          description: Number of results to return per page.
        - name: offset
          in: query
          type: integer
          description: The initial index from which to return the results.
        - name: updated_at
          in: query
          type: string
      - name: environmentshogflowscreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-environments-environment_id-hog_flows-bulk_delete
      path: /api/environments/{environment_id}/hog_flows/bulk_delete/
      operations:
      - name: environmentshogflowsbulkdeletecreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-environments-environment_id-hog_flows-user_blast_radius
      path: /api/environments/{environment_id}/hog_flows/user_blast_radius/
      operations:
      - name: environmentshogflowsuserblastradiuscreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-environments-environment_id-hog_flows-id
      path: /api/environments/{environment_id}/hog_flows/{id}/
      operations:
      - name: environmentshogflowsretrieve
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
      - name: environmentshogflowsupdate
        method: PUT
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: environmentshogflowspartialupdate
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: environmentshogflowsdestroy
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
    - name: api-environments-environment_id-hog_flows-id-batch_jobs
      path: /api/environments/{environment_id}/hog_flows/{id}/batch_jobs/
      operations:
      - name: environmentshogflowsbatchjobsretrieve
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
      - name: environmentshogflowsbatchjobscreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-environments-environment_id-hog_flows-id-blocked_runs
      path: /api/environments/{environment_id}/hog_flows/{id}/blocked_runs/
      operations:
      - name: environmentshogflowsblockedrunsretrieve
        method: GET
        description: List workflow runs that were blocked by the dedup bug.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
    - name: api-environments-environment_id-hog_flows-id-invocations
      path: /api/environments/{environment_id}/hog_flows/{id}/invocations/
      operations:
      - name: environmentshogflowsinvocationscreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-environments-environment_id-hog_flows-id-logs
      path: /api/environments/{environment_id}/hog_flows/{id}/logs/
      operations:
      - name: environmentshogflowslogsretrieve
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: after
          in: query
          type: string
          description: Only return entries after this ISO 8601 timestamp.
        - name: before
          in: query
          type: string
          description: Only return entries before this ISO 8601 timestamp.
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: instance_id
          in: query
          type: string
          description: Filter logs to a specific execution instance.
        - name: level
          in: query
          type: string
          description: 'Comma-separated log levels to include, e.g. ''WARN,ERROR''. Valid levels: DEBUG, LOG, INFO, WARN,
            ERROR.'
        - name: limit
          in: query
          type: integer
          description: Maximum number of log entries to return (1-500, default 50).
        - name: search
          in: query
          type: string
          description: Case-insensitive substring search across log messages.
    - name: api-environments-environment_id-hog_flows-id-metrics
      path: /api/environments/{environment_id}/hog_flows/{id}/metrics/
      operations:
      - name: environmentshogflowsmetricsretrieve
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: after
          in: query
          type: string
          description: Start of the time range. Accepts relative formats like '-7d', '-24h' or ISO 8601 timestamps. Defaults
            to '-7d'.
        - name: before
          in: query
          type: string
          description: End of the time range. Same format as 'after'. Defaults to now.
        - name: breakdown_by
          in: query
          type: string
          description: Group the series by metric 'name' or 'kind'. Defaults to 'kind'.
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: instance_id
          in: query
          type: string
          description: Filter metrics to a specific execution instance.
        - name: interval
          in: query
          type: string
          description: 'Time bucket size for the series. One of: hour, day, week. Defaults to ''day''.'
        - name: kind
          in: query
          type: string
          description: Comma-separated metric kinds to filter by, e.g. 'success,failure'.
        - name: name
          in: query
          type: string
          description: Comma-separated metric names to filter by.
    - name: api-environments-environment_id-hog_flows-id-metrics-totals
      path: /api/environments/{environment_id}/hog_flows/{id}/metrics/totals/
      operations:
      - name: environmentshogflowsmetricstotalsretrieve
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: after
          in: query
          type: string
          description: Start of the time range. Accepts relative formats like '-7d', '-24h' or ISO 8601 timestamps. Defaults
            to '-7d'.
        - name: before
          in: query
          type: string
          description: End of the time range. Same format as 'after'. Defaults to now.
        - name: breakdown_by
          in: query
          type: string
          description: Group the series by metric 'name' or 'kind'. Defaults to 'kind'.
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: instance_id
          in: query
          type: string
          description: Filter metrics to a specific execution instance.
        - name: interval
          in: query
          type: string
          description: 'Time bucket size for the series. One of: hour, day, week. Defaults to ''day''.'
        - name: kind
          in: query
          type: string
          description: Comma-separated metric kinds to filter by, e.g. 'success,failure'.
        - name: name
          in: query
          type: string
          description: Comma-separated metric names to filter by.
    - name: api-environments-environment_id-hog_flows-id-replay_all_blocked_runs
      path: /api/environments/{environment_id}/hog_flows/{id}/replay_all_blocked_runs/
      operations:
      - name: environmentshogflowsreplayallblockedrunscreate
        method: POST
        description: Replay all blocked runs in a single bulk call to Node.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-environments-environment_id-hog_flows-id-replay_blocked_run
      path: /api/environments/{environment_id}/hog_flows/{id}/replay_blocked_run/
      operations:
      - name: environmentshogflowsreplayblockedruncreate
        method: POST
        description: Replay a single blocked run. Django fetches the event, Node creates the invocation and writes the log.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-environments-environment_id-hog_flows-id-schedules
      path: /api/environments/{environment_id}/hog_flows/{id}/schedules/
      operations:
      - name: environmentshogflowsscheduleslist
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: created_at
          in: query
          type: string
        - name: created_by
          in: query
          type: integer
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: id
          in: query
          type: string
        - name: limit
          in: query
          type: integer
          description: Number of results to return per page.
        - name: offset
          in: query
          type: integer
          description: The initial index from which to return the results.
        - name: updated_at
          in: query
          type: string
      - name: environmentshogflowsschedulescreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: created_at
          in: query
          type: string
        - name: created_by
          in: query
          type: integer
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: id
          in: query
          type: string
        - name: limit
          in: query
          type: integer
          description: Number of results to return per page.
        - name: offset
          in: query
          type: integer
          description: The initial index from which to return the results.
        - name: updated_at
          in: query
          type: string
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-environments-environment_id-hog_flows-id-schedules-schedule_id
      path: /api/environments/{environment_id}/hog_flows/{id}/schedules/{schedule_id}/
      operations:
      - name: environmentshogflowsschedulespartialupdate
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: schedule_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: environmentshogflowsschedulesdestroy
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: schedule_id
          in: path
          type: string
          required: true
    - name: api-projects-project_id-hog_flows
      path: /api/projects/{project_id}/hog_flows/
      operations:
      - name: hogflowslist
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: created_at
          in: query
          type: string
        - name: created_by
          in: query
          type: integer
        - name: id
          in: query
          type: string
        - name: limit
          in: query
          type: integer
          description: Number of results to return per page.
        - name: offset
          in: query
          type: integer
          description: The initial index from which to return the results.
        - name: updated_at
          in: query
          type: string
      - name: hogflowscreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-hog_flows-bulk_delete
      path: /api/projects/{project_id}/hog_flows/bulk_delete/
      operations:
      - name: hogflowsbulkdeletecreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-hog_flows-user_blast_radius
      path: /api/projects/{project_id}/hog_flows/user_blast_radius/
      operations:
      - name: hogflowsuserblastradiuscreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-hog_flows-id
      path: /api/projects/{project_id}/hog_flows/{id}/
      operations:
      - name: hogflowsretrieve
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
      - name: hogflowsupdate
        method: PUT
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: hogflowspartialupdate
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: hogflowsdestroy
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
    - name: api-projects-project_id-hog_flows-id-batch_jobs
      path: /api/projects/{project_id}/hog_flows/{id}/batch_jobs/
      operations:
      - name: hogflowsbatchjobsretrieve
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
      - name: hogflowsbatchjobscreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-hog_flows-id-blocked_runs
      path: /api/projects/{project_id}/hog_flows/{id}/blocked_runs/
      operations:
      - name: hogflowsblockedrunsretrieve
        method: GET
        description: List workflow runs that were blocked by the dedup bug.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
    - name: api-projects-project_id-hog_flows-id-invocations
      path: /api/projects/{project_id}/hog_flows/{id}/invocations/
      operations:
      - name: hogflowsinvocationscreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-hog_flows-id-logs
      path: /api/projects/{project_id}/hog_flows/{id}/logs/
      operations:
      - name: hogflowslogsretrieve
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: after
          in: query
          type: string
          description: Only return entries after this ISO 8601 timestamp.
        - name: before
          in: query
          type: string
          description: Only return entries before this ISO 8601 timestamp.
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: instance_id
          in: query
          type: string
          description: Filter logs to a specific execution instance.
        - name: level
          in: query
          type: string
          description: 'Comma-separated log levels to include, e.g. ''WARN,ERROR''. Valid levels: DEBUG, LOG, INFO, WARN,
            ERROR.'
        - name: limit
          in: query
          type: integer
          description: Maximum number of log entries to return (1-500, default 50).
        - name: search
          in: query
          type: string
          description: Case-insensitive substring search across log messages.
    - name: api-projects-project_id-hog_flows-id-metrics
      path: /api/projects/{project_id}/hog_flows/{id}/metrics/
      operations:
      - name: hogflowsmetricsretrieve
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: after
          in: query
          type: string
          description: Start of the time range. Accepts relative formats like '-7d', '-24h' or ISO 8601 timestamps. Defaults
            to '-7d'.
        - name: before
          in: query
          type: string
          description: End of the time range. Same format as 'after'. Defaults to now.
        - name: breakdown_by
          in: query
          type: string
          description: Group the series by metric 'name' or 'kind'. Defaults to 'kind'.
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: instance_id
          in: query
          type: string
          description: Filter metrics to a specific execution instance.
        - name: interval
          in: query
          type: string
          description: 'Time bucket size for the series. One of: hour, day, week. Defaults to ''day''.'
        - name: kind
          in: query
          type: string
          description: Comma-separated metric kinds to filter by, e.g. 'success,failure'.
        - name: name
          in: query
          type: string
          description: Comma-separated metric names to filter by.
    - name: api-projects-project_id-hog_flows-id-metrics-totals
      path: /api/projects/{project_id}/hog_flows/{id}/metrics/totals/
      operations:
      - name: hogflowsmetricstotalsretrieve
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: after
          in: query
          type: string
          description: Start of the time range. Accepts relative formats like '-7d', '-24h' or ISO 8601 timestamps. Defaults
            to '-7d'.
        - name: before
          in: query
          type: string
          description: End of the time range. Same format as 'after'. Defaults to now.
        - name: breakdown_by
          in: query
          type: string
          description: Group the series by metric 'name' or 'kind'. Defaults to 'kind'.
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: instance_id
          in: query
          type: string
          description: Filter metrics to a specific execution instance.
        - name: interval
          in: query
          type: string
          description: 'Time bucket size for the series. One of: hour, day, week. Defaults to ''day''.'
        - name: kind
          in: query
          type: string
          description: Comma-separated metric kinds to filter by, e.g. 'success,failure'.
        - name: name
          in: query
          type: string
          description: Comma-separated metric names to filter by.
    - name: api-projects-project_id-hog_flows-id-replay_all_blocked_runs
      path: /api/projects/{project_id}/hog_flows/{id}/replay_all_blocked_runs/
      operations:
      - name: hogflowsreplayallblockedrunscreate
        method: POST
        description: Replay all blocked runs in a single bulk call to Node.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-hog_flows-id-replay_blocked_run
      path: /api/projects/{project_id}/hog_flows/{id}/replay_blocked_run/
      operations:
      - name: hogflowsreplayblockedruncreate
        method: POST
        description: Replay a single blocked run. Django fetches the event, Node creates the invocation and writes the log.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-hog_flows-id-schedules
      path: /api/projects/{project_id}/hog_flows/{id}/schedules/
      operations:
      - name: hogflowsscheduleslist
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: created_at
          in: query
          type: string
        - name: created_by
          in: query
          type: integer
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: id
          in: query
          type: string
        - name: limit
          in: query
          type: integer
          description: Number of results to return per page.
        - name: offset
          in: query
          type: integer
          description: The initial index from which to return the results.
        - name: updated_at
          in: query
          type: string
      - name: hogflowsschedulescreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: created_at
          in: query
          type: string
        - name: created_by
          in: query
          type: integer
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: id
          in: query
          type: string
        - name: limit
          in: query
          type: integer
          description: Number of results to return per page.
        - name: offset
          in: query
          type: integer
          description: The initial index from which to return the results.
        - name: updated_at
          in: query
          type: string
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-hog_flows-id-schedules-schedule_id
      path: /api/projects/{project_id}/hog_flows/{id}/schedules/{schedule_id}/
      operations:
      - name: hogflowsschedulespartialupdate
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this hog flow.
          required: true
        - name: schedule_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: hogflowsschedulesdestroy
        method: DELETE
        description: ''
        outputRawForm

# --- truncated at 32 KB (71 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/posthog/refs/heads/main/capabilities/posthog-hog-flows.yaml