EvaluationRunRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/EvaluationRunRequest",
  "title": "EvaluationRunRequest",
  "type": "object",
  "properties": {
    "evaluation_id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID of the evaluation to run."
    },
    "target_event_id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID of the $ai_generation event to evaluate."
    },
    "timestamp": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp of the target event (needed for efficient ClickHouse lookup)."
    },
    "event": {
      "type": "string",
      "default": "$ai_generation",
      "description": "Event name. Defaults to '$ai_generation'."
    },
    "distinct_id": {
      "type": "string",
      "nullable": true,
      "description": "Distinct ID of the event (optional, improves lookup performance)."
    }
  },
  "required": [
    "evaluation_id",
    "target_event_id",
    "timestamp"
  ]
}