v3

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

List Experiments

POST method for filtered listing (same as GET).

post/api/v2/experiments/list/

Headers

Authorizationstring required

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Request body

idstring
namestring
datasetstring nullable
workflow_countinteger
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
started_atstring date-time nullable
completed_atstring date-time nullable
descriptionstring
is_starredboolean

Response

idstring
namestring
datasetstring nullable
dataset_namestring nullable required
modelstring nullable required
workflow_countinteger
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
created_atstring date-time required
started_atstring date-time nullable
completed_atstring date-time nullable
descriptionstring
is_starredboolean
prompt_namestring nullable required
evaluator_namesstring[] required
evaluator_scoresobject[] required