List a suite's cases

GET
/v1/tests/{id}/cases

The cases of a test suite: each is the contact's lines (a conversation that went wrong, replayed, or a script you wrote) and what its run must reach.

Requires an API key with the workspace:read scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Path Parameters

id*string

The suite id.

Response Body

The suite's cases

application/json
  1. response
cases*array<>
Example Request
curl "https://api.vlayers.ai/v1/tests/$SUITE_ID/cases" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "cases": [    {      "id": "0192f5f9-d2e1-7c3f-9e8f-90123456789a",      "suiteId": "0192f5f8-c1d0-7b2e-8d7e-8f9012345678",      "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78",      "name": "Refund went wrong",      "inputKind": "replay",      "turns": [        "I was charged twice",        "Yes, the card ending 4242"      ],      "sourceCallId": null,      "sourceConversationId": "0192f5b0-7c3e-7a51-9b2d-4e8f1a6c3d21",      "expectations": [        {          "evaluationId": "0192f5f7-b0cf-7a1d-9c6d-7e8f90123456",          "expect": {            "bool": true          }        }      ],      "createdBy": "user_2abc",      "createdAt": "2026-10-20T15:04:05.000Z",      "expiresAt": null    }  ]}