Create an experiment | Respan Docs

Create a new experiment with workflows. Supports custom (submit results via API), completion (auto-run LLM calls), and prompt (test prompt versions) workflow types.

Request

This endpoint expects an object.

namestringRequired

Experiment name.

dataset_idstringRequired

Dataset ID to run against.

descriptionstringOptional

Experiment description.

workflowslist of objectsOptional

Array of workflow configs. Each has type, config, and optional settings.

evaluator_slugslist of stringsOptional

Evaluator slugs to auto-run on results.

Response

Successful response for Create experiment

idstring

namestring

descriptionstring

dataset_idstring

workflowslist of objects

evaluator_slugslist of strings

statusstring

created_atstring

updated_atstring

Errors

401

Unauthorized Error

1	curl -X POST https://api.respan.ai/api/v2/experiments/ \
2	-H "Authorization: Bearer sk_live_xxxxx" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"name": "model-comparison",
6	"dataset_id": "ds_abc123"
7	}'

1	{
2	"id": "experiment-123",
3	"name": "My Custom Workflow Experiment",
4	"description": "Testing custom workflow implementation",
5	"dataset_id": "your-dataset-id",
6	"workflows": [
7	{
8	"type": "custom",
9	"config": {
10	"allow_submission": true,
11	"timeout_hours": 24
12	}
13	}
14	],
15	"evaluator_slugs": [
16	"response_quality_v1",
17	"factual_accuracy"
18	],
19	"status": "running",
20	"created_at": "2025-11-18T10:00:00Z",
21	"updated_at": "2025-11-18T10:00:00Z"
22	}

Headers

Request

Response

Errors