Sign in

v3

latestOpenAPI 3.1.02026-07-311,4541,5202.3 MB
experiments

Api V 2 Experiments Create 2

POST handler with superadmin-only field protection.

Strips superadmin-only fields from non-superadmin requests before delegating to OrganizationInjectionMixin.post() for org injection.

post/api/v2/experiments/{experiment_id}/

Path parameters

experiment_idstring required

Headers

Authorizationstring required

JWT access token or Respan API key

Request body

projectstring nullable
namestring
descriptionstring
{"stackTrail":"components:schemas:ExperimentV2Request:properties:workflow","oasType":"schema","type":"unknown","description":"Any type"}
workflow_countinteger
evaluator_slugsstring[]

List of evaluators to run for producing scores for comparison

evaluator_workflow_idsstring[]

List of WorkflowVersion IDs (eval_only) defining evaluator pipelines. Mutually exclusive with evaluator_slugs.

resource_idsstring[]

All resource IDs referenced (evaluators, prompts) for reverse lookup on deletion

batch_sizeinteger
concurrencyinteger
enable_tracingboolean
status'draft' | 'pending' | 'paused' | 'running' | 'waiting_for_annotations' | 'completed' | 'failed'
  • draft - Draft
  • pending - Pending
  • paused - Paused
  • running - Running
  • waiting_for_annotations - Waiting For Annotations
  • completed - Completed
  • failed - Failed
progressnumber double
{"stackTrail":"components:schemas:ExperimentV2Request:properties:metadata","oasType":"schema","type":"unknown","description":"Any type"}
is_starredboolean
started_atstring date-time nullable
completed_atstring date-time nullable
datasetstring nullable
task_trackerstring nullable

Response

idstring required
evaluator_idsstring required
projectstring nullable
namestring
descriptionstring
unique_organization_idstring required
{"stackTrail":"components:schemas:ExperimentV2:properties:workflow","oasType":"schema","type":"unknown","description":"Any type"}
workflow_countinteger
evaluator_slugsstring[]

List of evaluators to run for producing scores for comparison

evaluator_workflow_idsstring[]

List of WorkflowVersion IDs (eval_only) defining evaluator pipelines. Mutually exclusive with evaluator_slugs.

resource_idsstring[]

All resource IDs referenced (evaluators, prompts) for reverse lookup on deletion

batch_sizeinteger
concurrencyinteger
enable_tracingboolean
status'draft' | 'pending' | 'paused' | 'running' | 'waiting_for_annotations' | 'completed' | 'failed'
  • draft - Draft
  • pending - Pending
  • paused - Paused
  • running - Running
  • waiting_for_annotations - Waiting For Annotations
  • completed - Completed
  • failed - Failed
progressnumber double
{"stackTrail":"components:schemas:ExperimentV2:properties:metadata","oasType":"schema","type":"unknown","description":"Any type"}
is_starredboolean
created_atstring date-time required
updated_atstring date-time required
started_atstring date-time nullable
completed_atstring date-time nullable
organizationinteger required
created_byinteger nullable required
datasetstring nullable
task_trackerstring nullable