​
Endpoint: POST /{agentId}/start

This endpoint starts a new conversation session with an AI agent.

​
Request

curl -X POST https://iwy-ai--iwy-backend-start.modal.run/your-agent-id/start \
  -H "Authorization: Bearer super-secret-token" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "your-agent-id",
    "createDailyRoom": true,
    "dailyRoomProperties": {},
    "callback_url": "https://example.com/callback",
    "device_info": {},
    "context": {}
  }'

​
Path Parameters

​
agentId
string
required
The ID of the agent to start the session with.

​
Headers

​
Authorization
string
required
Authentication requires a Bearer token. Example: Bearer super-secret-token

​
Body Parameters

​
agent_id
string
required
The agent ID. This should match the agentId in the URL path.
​
createDailyRoom
boolean
Whether to create a Daily.co room for video chat.
​
dailyRoomProperties
object
Configuration for the Daily.co room.
​
callback_url
string
URL for the session to send callbacks to.
​
device_info
object
Optional device information.
​
context
object
Optional context data for the conversation.