Skip to main content

Create a voice session (in progress)

POST 
/api/v1/llm/create-daily-session

Starts the configured hosted-provider voice session for an initialized conversation. Confirm room connection and agent readiness through provider events. A returned session alone does not establish that the agent joined or that transcripts were stored in conversation history.

At session end, handle room expiry and the client's local capture separately; a local disconnect alone does not establish remote cleanup.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Add a spoken conversation to your app (Preview)

Request​

Responses​

Voice session created

Schema-valid request illustration; replace example identifiers and confirm operation prerequisites.​

Section ID: DOC-MA-conversations-api-createDailySession#example-conversations-createDailySession-request

Request example

{
  "conversationKey": "example_123"
}

Guide request for Step 1: Start the voice session for the existing thread. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-MA-conversations-api-createDailySession#example-cookbook-managed-agents-voice-media-index-01-request

Request example

{
  "conversationKey": "support-chat-001",
  "agentName": "my-voice-agent",
  "createDailyRoom": true,
  "dailyRoomProperties": {
    "enableRecording": "RECORDING_MODE_DISABLED"
  }
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.​

Section ID: DOC-MA-conversations-api-createDailySession#example-conversations-createDailySession-response

Response example

{
  "session": {
    "agentName": "example",
    "sessionId": "example_123",
    "dailyRoom": "example",
    "dailyToken": "example",
    "userData": {},
    "dailyRoomProperties": {
      "nbf": "1",
      "exp": "1",
      "maxParticipants": 1,
      "enablePeopleUi": true,
      "enablePipUi": true,
      "enableEmojiReactions": true,
      "enableHandRaising": true,
      "enablePrejoinUi": true,
      "enableLiveCaptionsUi": true,
      "enableNetworkUi": true,
      "enableNoiseCancellationUi": true,
      "enableBreakoutRooms": true,
      "enableKnocking": true,
      "ownerOnlyBroadcast": true,
      "enforceUniqueUserIds": true,
      "enableScreenshare": true,
      "enableVideoProcessingUi": true,
      "enableChat": true,
      "enableSharedChatHistory": true,
      "enableAdvancedChat": true,
      "enableHiddenParticipants": true,
      "startVideoOff": true,
      "startAudioOff": true,
      "enableRecording": "RECORDING_MODE_CLOUD",
      "ejectAtRoomExp": true,
      "ejectAfterElapsed": 1,
      "enableMeshSfu": true,
      "sfuSwitchover": 1,
      "enableAdaptiveSimulcast": true,
      "enableMultipartyAdaptiveSimulcast": true,
      "experimentalOptimizeLargeCalls": true,
      "lang": "example",
      "meetingJoinHook": "example",
      "geo": "example",
      "rtmpGeo": "example",
      "disableRtmpGeoFallback": true,
      "recordingsTemplate": "example",
      "transcriptionTemplate": "example"
    },
    "dailyMeetingTokenProperties": {
      "isOwner": true,
      "enableAutoRecording": true
    },
    "startedAt": "2026-09-16T12:00:00Z"
  }
}

Illustrative response for Step 2: Join the room and confirm the exchange. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-MA-conversations-api-createDailySession#example-cookbook-managed-agents-voice-media-index-json-01-response

Response example

{
  "session": {
    "sessionId": "sess_abc123",
    "agentName": "my-voice-agent",
    "dailyRoom": "travila-abc123",
    "dailyToken": "eyJ...",
    "startedAt": "2026-08-17T10:00:00Z",
    "userData": {
      "fields": {
        "displayName": "Alex"
      }
    },
    "dailyRoomProperties": {
      "exp": "1786964400"
    },
    "dailyMeetingTokenProperties": {
      "isOwner": false
    }
  }
}

Document ID: DOC-MA-conversations-api-createDailySession. Section identities and revisions.

SectionStable reference
Create a voice session (in progress)DOC-MA-conversations-api-createDailySession#overview
RequestDOC-MA-conversations-api-createDailySession#request
ResponsesDOC-MA-conversations-api-createDailySession#responses