Create an experiment | Sarvam API Docs

import requests
url = "https://apps.sarvam.ai/api/scheduling/v1/orgs/org_id/workspaces/workspace_id/experiments"
payload = {
    "name": "greeting-test",
    "variants": [
        {
            "name": "control",
            "traffic_percentage": 50,
            "app_config": {
                "app_id": "payment-reminder-agent",
                "app_version": 3
            }
        },
        {
            "name": "casual",
            "traffic_percentage": 50,
            "app_config": {
                "app_id": "payment-reminder-agent",
                "app_version": 4
            }
        }
    ],
    "description": "Formal vs casual opener",
    "app_type": "agent"
}
headers = {
    "X-API-Key": "<your-api-key>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "experiment_id": "greeting-te-9f1c2a7b-4d3e",
  "name": "greeting-test",
  "app_type": "agent",
  "variants": [
    {
      "variant_id": "control-1a2b3c4d-5e6f",
      "name": "control",
      "traffic_percentage": 50,
      "app_config": {
        "app_id": "payment-reminder-agent",
        "app_version": 3
      }
    },
    {
      "variant_id": "casual-7a8b9c0d-1e2f",
      "name": "casual",
      "traffic_percentage": 50,
      "app_config": {
        "app_id": "payment-reminder-agent",
        "app_version": 4
      }
    }
  ],
  "created_by": "user@company.com",
  "created_at": "2026-10-28T08:00:00Z",
  "updated_at": "2026-10-28T08:00:00Z",
  "description": "Formal vs casual opener",
  "updated_by": null
}

Create an experiment across committed versions of one agent. Then create a campaign that runs it — see Create Experiment Campaign.

Path parameters

org_idstringRequired

workspace_idstringRequired

Request

This endpoint expects an object.

namestringRequiredformat: "^[\w\- ]{1,50}$"<=50 characters

A/B test name. Letters, digits, spaces, hyphens, and underscores. Max 50 characters.

variantslist of objectsRequired

Two to five variants. traffic_percentage must sum to 100. Each variant uses a different committed version of the same agent.

descriptionstring or nullOptional<=150 characters

Optional description. Max 150 characters.

app_typeenumOptionalDefaults to agent

Must be agent.

Allowed values:

Response

Successful Response

experiment_idstring

Id to pass as app_config.experiment_id when creating a campaign.

namestring

app_typeenum

Allowed values:

variantslist of objects

created_bystring

created_atdatetime

updated_atdatetime

descriptionstring or nullOptional

updated_bystring or nullOptional

Errors

422

Unprocessable Entity Error

Path parameters

Headers

Request

Response

Errors