create

create(
  self,
  dataset_id: str,
  *,
  comparative_experiment_id:

'REFERENCE_EXAMPLE_ID'

'REFERENCE_DATASET_ID'

'PROMPT_TOKEN_DETAILS'

'COMPLETION_TOKEN_DETAILS'

'PROMPT_COST_DETAILS'

'COMPLETION_COST_DETAILS'

'THREAD_EVALUATION_TIME'

experiment_run_create_params

Parameters

Name	Type	Description
`comparative_experiment_id`	`str \| Omit`	Default:`omit` `comparative_experiment_id` scopes pairwise-annotation feedback (optional).
`cursor`	`str \| Omit`	Default:`omit` `cursor` is the opaque string from a previous response's `next_cursor`. Absent for the first page.
`example_ids`	`SequenceNotStr[str] \| Omit`	Default:`omit`
`experiment_ids`	`SequenceNotStr[str] \| Omit`	Default:`omit`
`filters`	`Dict[str, SequenceNotStr[str]] \| Omit`	Default:`omit`
`page_size`	`int \| Omit`	Default:`omit`
`selects`	List[Literal['ID', 'NAME', 'RUN_TYPE', 'STATUS', 'START_TIME', 'END_TIME', 'LATENCY_SECONDS', 'FIRST_TOKEN_TIME', 'ERROR', 'ERROR_PREVIEW', 'EXTRA', 'METADATA', 'EVENTS', 'INPUTS', 'INPUTS_PREVIEW', 'OUTPUTS', 'OUTPUTS_PREVIEW', 'MANIFEST', 'PARENT_RUN_IDS', 'PROJECT_ID', 'TRACE_ID', 'THREAD_ID', 'DOTTED_ORDER', 'IS_ROOT', 'REFERENCE_EXAMPLE_ID', 'REFERENCE_DATASET_ID', 'TOTAL_TOKENS', 'PROMPT_TOKENS', 'COMPLETION_TOKENS', 'TOTAL_COST', 'PROMPT_COST', 'COMPLETION_COST', 'PROMPT_TOKEN_DETAILS', 'COMPLETION_TOKEN_DETAILS', 'PROMPT_COST_DETAILS', 'COMPLETION_COST_DETAILS'
`sort`	`experiment_run_create_params.Sort \| Omit`	Default:`omit`
`extra_headers`	`Headers \| None`	Default:`None`
`extra_query`	`Query \| None`	Default:`None`
`extra_body`	`Body \| None`	Default:`None`
`timeout`	`float \| httpx.Timeout \| None \| NotGiven`	Default:`not_given`

Returns a paginated page of dataset examples with runs from the requested experiments. Response uses the canonical {items, next_cursor} envelope.

'THREAD_EVALUATION_TIME'

example_ids optionally restricts the page to these dataset example UUIDs (max 1000).

experiment_ids lists the experiment (tracing session) UUIDs to query. Required, non-empty.

filters maps a project (session) UUID string to a list of filter expressions (optional).

page_size is the maximum number of examples to return. Defaults to 20, max 100.

sort controls feedback-score sorting (single project only).

Add additional query parameters to the request

Add additional JSON properties to the request

Override the client-level default timeout for this request, in seconds

selects lists which run properties to include. Omitted => only id. Tokens mirror /v2/runs/query.