​
Endpoint

POST /test-runs/create-livekit-rooms

​
Authentication

This endpoint requires authentication.

​
Request Body

ParameterTypeDescription
datasetIdstringID of the dataset to use
datasetItemIdsstring[]Optional list of dataset item IDs to filter by

​
Response

{
  "experimentId": "string",
  "rooms": [
    {
      "roomName": "string",
      "url": "string",
      "datasetItemId": "string",
      "token": "string"
    }
  ]
}

​
Example Usage

// Create LiveKit rooms for a specific dataset
const response = await fetch('https://app.hamming.ai/api/rest/test-runs/create-livekit-rooms', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_TOKEN'
  },
  body: JSON.stringify({
    datasetId: 'ds_abc123',
    datasetItemIds: ['di_xyz789', 'di_def456'] // Optional
  })
});

const result = await response.json();
console.log(result);
/*
{
  "experimentId": "exp_123abc",
  "rooms": [
    {
      "roomName": "direct_call_abc123",
      "url": "wss://livekit.hamming.ai",
      "datasetItemId": "di_xyz789",
      "token": "eyJhbG..."
    },
    {
      "roomName": "direct_call_def456",
      "url": "wss://livekit.hamming.ai",
      "datasetItemId": "di_def456",
      "token": "eyJhbG..."
    }
  ]
}
*/

​
Using LiveKit Room Data

The returned tokens can be used to establish direct WebRTC connections to the LiveKit rooms, where voice agent interactions can take place without traditional telephony integration.