​
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.

Was this page helpful?