Get a test suite | Sarvam API Docs

import requests
url = "https://apps.sarvam.ai/api/evals/v1/org_id/workspace_id/test-suites/test_suite_id"
headers = {"X-API-Key": "<your-api-key>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "test_suite_id": "01K5T8A2MZQ4VE6XCJ0RDBHW7N",
  "name": "Front desk — booking flows",
  "test_case_count": 8,
  "created_by": {
    "type": "api_key",
    "id": "sk_live_7f3ab1"
  },
  "created_at": "2026-09-10T08:42:00Z",
  "updated_at": "2026-09-15T11:20:36Z",
  "app_id": "clinic-front-desk",
  "description": "Rescheduling, cancellations, and identity checks for the clinic agent.",
  "variables": [
    {
      "name": "clinic_name",
      "value": "Sunrise Dental"
    },
    {
      "name": "patient_name",
      "value": "Ravi"
    }
  ],
  "global_guardrails": [
    "Never gives medical advice; clinical questions are directed to a doctor.",
    "Confirms the patient's full name and phone number before changing a booking."
  ],
  "test_cases": [
    {
      "test_case_id": "01K5T8B7PS3KD9GM1FYX4VQCJ2",
      "name": "Caller reschedules to the weekend",
      "category": "Rescheduling",
      "user_scenario": "The caller has an appointment tomorrow morning but now wants a weekend slot. They are in a hurry, switch to Hindi midway, and ask twice whether a cancellation fee applies.",
      "expected_behaviors": [
        {
          "name": "Offers concrete slots",
          "description": "Proposes at least two specific dates and times instead of asking the caller to choose blindly."
        },
        {
          "name": "Confirms the new booking",
          "description": "Repeats the final date, time and clinic name back to the caller before ending the call."
        }
      ],
      "variable_overrides": [
        {
          "name": "patient_name",
          "value": "Meera"
        }
      ],
      "max_turns": 30
    }
  ],
  "updated_by": {
    "type": "user",
    "id": "usr_2c94e7d1"
  }
}

Returns the suite with its test cases nested.

Path parameters

org_idstringRequired

Organization ID

workspace_idstringRequired

Workspace ID

test_suite_idstringRequired

Response

Successful Response

test_suite_idstring

namestring

test_case_countinteger

created_byobject

created_atdatetime

updated_atdatetime

app_idstring or nullOptional

App this suite is bound to, or null for a workspace-level suite.

descriptionstring or nullOptional

variableslist of objectsOptionalDefaults to []

global_guardrailslist of stringsOptionalDefaults to []

test_caseslist of objectsOptionalDefaults to []

updated_byobject or nullOptional

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

Path parameters

Headers

Response

Errors