evaluation_runs

Create a new evaluation run.

This endpoint validates the request and enqueues a Temporal workflow to asynchronously execute the evaluation.

post/api/projects/{project_id}/evaluation_runs/

Request

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

Path parameters

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

evaluation_idstring uuid required

UUID of the evaluation to run.

target_event_idstring uuid required

UUID of the $ai_generation event to evaluate.

timestampstring date-time required

ISO 8601 timestamp of the target event (needed for efficient ClickHouse lookup).

eventstring

Event name. Defaults to '$ai_generation'.

distinct_idstring nullable

Distinct ID of the event (optional, improves lookup performance).

Response

workflow_idstring required

Temporal workflow ID of the enqueued run.

statusstring required

Workflow status at the time of the response.

target_event_idstring uuid required

UUID of the event being evaluated.

Changes

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