Experiments

Create a experiment

Create a new experiment

post/v4/experiments

Request body

namestring

Friendly experiment name

pipelineIdstring uuid required

The ID of the pipeline to create the experiment for

metadataobject

Optional metadata for the experiment

Example request

{
  "pipelineId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "OpenAI o3-mini prompt",
  "metadata": {
    "promptTemplate": {
      "type": "string",
      "value": "Hello, {{ name }}!"
    }
  }
}

Response

Successful response

idstring uuid required

Experiment UUID

createdAtstring required

Creation timestamp (ISO 8601)

updatedAtstring required

Last update timestamp (ISO 8601)

namestring nullable required

Friendly experiment name

pipelineIdstring required

Pipeline UUID

metadataobject nullable required

Metadata

Example response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-04-01T00:00:00.000Z",
  "updatedAt": "2025-04-01T00:00:00.000Z",
  "name": "OpenAI o3-mini prompt",
  "pipelineId": "123e4567-e89b-12d3-a456-426614174000",
  "metadata": {
    "key": "value"
  }
}

Changes