Skip to main content
POST
/
start-agent-session
curl --request POST \
  --url https://api.iwy.ai/v1/start-agent-session \
  --header 'Content-Type: application/json' \
  --data '
{
  "agentId": "550e8400-e29b-41d4-a716-446655440000"
}
'
{
  "roomUrl": "https://iwy.daily.co/abc123xyz",
  "dailyToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "webLink": "https://meet.iwy.ai/550e8400-e29b-41d4-a716-446655440000"
}

Body

application/json

Request to start a video call session with an agent

​
agentId
string
required

The agent ID (UUID) to start a session with, or 'demo' for a demo session

Example:

"550e8400-e29b-41d4-a716-446655440000"

Response

Session started successfully

Response containing Daily.co room connection details and a web link for browser-based access

​
roomUrl
string<uri>
required

The Daily.co room URL to join

Example:

"https://iwy.daily.co/abc123xyz"

​
dailyToken
string
required

Authentication token for joining the Daily.co room

Example:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

​
webLink
string<uri>
required

A shareable web link for joining the agent session in a browser

Example:

"https://meet.iwy.ai/550e8400-e29b-41d4-a716-446655440000"