Update Experiment

PATCH

https://api.respan.ai/api/v2/experiments/:experiment_id/

PATCH handler with superadmin lock and field protection.

Checks:

Object lock (is_managed=True -> non-superadmins can’t modify)
Field protection (non-superadmins can’t modify specific fields)

Authentication

AuthorizationBearer

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.

AuthorizationBearer

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

Path parameters

experiment_idstringRequired

Request

This endpoint expects an object.

namestringOptional<=255 characters

descriptionstringOptional

datasetstring or nullOptional>=1 character

workflowanyOptional

evaluator_slugslist of stringsOptional

List of evaluators to run for producing scores for comparison

evaluator_workflow_idslist of stringsOptional

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

batch_sizeintegerOptional-2147483648-2147483647

concurrencyintegerOptional-2147483648-2147483647

enable_tracingbooleanOptional

is_starredbooleanOptional

Response