Skip to main content
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#overview

DailyRoomProperties

Daily room configuration (subset of frequently used fields)

Meaning and usage​

Section ID: DOC-API-MODEL-schema-1kp6t31pq7#meaning

See the definition above.

Usage profiles​

Section ID: DOC-API-MODEL-schema-1kp6t31pq7#fields

UsageFields and validation
In requestsView fields
In responsesView fields

In requests​

Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request

API JSON uses JSON field names (camelCase).

FieldTypePresenceMeaning
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-nbfnbfstring (int64)OptionalEarliest time at which the Daily room can be joined, as Unix seconds. Pattern: ^-?\d+$.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-expexpstring (int64)OptionalExpiration time of the Daily room, as Unix seconds. Pattern: ^-?\d+$.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-maxparticipantsmaxParticipantsstring (int64)OptionalMaximum number of participants allowed in the Daily room. Pattern: ^-?\d+$.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enablepeopleuienablePeopleUibooleanOptionalWhether the Daily room exposes participant-list controls.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enablepipuienablePipUibooleanOptionalWhether the Daily room enables picture-in-picture controls.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enableemojireactionsenableEmojiReactionsbooleanOptionalWhether the Daily room enables emoji reactions.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enablehandraisingenableHandRaisingbooleanOptionalWhether the Daily room enables hand-raising controls.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enableprejoinuienablePrejoinUibooleanOptionalWhether the Daily room enables its prejoin screen.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enablelivecaptionsuienableLiveCaptionsUibooleanOptionalWhether the Daily room exposes live-caption controls.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enablenetworkuienableNetworkUibooleanOptionalWhether the Daily room exposes network-information controls.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enablenoisecancellationuienableNoiseCancellationUibooleanOptionalWhether the Daily room exposes noise-cancellation controls.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enablebreakoutroomsenableBreakoutRoomsbooleanOptionalWhether the Daily room enables breakout rooms.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enableknockingenableKnockingbooleanOptionalWhen true, requests Daily’s knocking feature for a private room, allowing a participant without a meeting token to ask a meeting owner for admission. It does not restrict a public room. The current room-property mapping forwards true only; false or omission does not explicitly disable a provider setting.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-owneronlybroadcastownerOnlyBroadcastbooleanOptionalWhether broadcasting is restricted to Daily room owners.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enforceuniqueuseridsenforceUniqueUserIdsbooleanOptionalWhether the Daily room requires participant user identifiers to be unique.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enablescreenshareenableScreensharebooleanOptionalWhether screen sharing is enabled in the Daily room.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enablevideoprocessinguienableVideoProcessingUibooleanOptionalWhether the Daily room exposes video-processing controls.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enablechatenableChatbooleanOptionalWhether chat is enabled in the Daily room.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enablesharedchathistoryenableSharedChatHistorybooleanOptionalWhether the Daily room enables shared chat history.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enableadvancedchatenableAdvancedChatbooleanOptionalWhether the Daily room enables advanced chat features.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enablehiddenparticipantsenableHiddenParticipantsbooleanOptionalWhether the Daily room allows hidden participants.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-startvideooffstartVideoOffbooleanOptionalWhether participants join the Daily room with video initially off.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-startaudiooffstartAudioOffbooleanOptionalWhether participants join the Daily room with audio initially off.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enablerecordingenableRecordingstring (RECORDING_MODE_CLOUD, RECORDING_MODE_LOCAL, RECORDING_MODE_RAW_TRACKS, RECORDING_MODE_DISABLED) or integer (int32)Optional; explicit presenceRecording mode configured for the Daily room.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-ejectatroomexpejectAtRoomExpbooleanOptionalWhether participants are removed when the Daily room expires.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-ejectafterelapsedejectAfterElapsedstring (int64)OptionalElapsed session duration after which participants are removed, in seconds. Pattern: ^-?\d+$.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enablemeshsfuenableMeshSfubooleanOptionalWhen true, forwards Daily’s enable_mesh_sfu room-topology option. Confirm provider support and its effect for your Daily account before relying on it. The current room-property mapping forwards true only; false or omission does not explicitly disable a provider setting.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-sfuswitchoversfuSwitchovernumber (double) or string (NaN, Infinity, -Infinity)OptionalDaily topology setting controlling the switch to SFU transport.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enableadaptivesimulcastenableAdaptiveSimulcastbooleanOptionalWhether adaptive simulcast is enabled for the Daily room.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-enablemultipartyadaptivesimulcastenableMultipartyAdaptiveSimulcastbooleanOptionalWhether multiparty adaptive simulcast is enabled for the Daily room.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-experimentaloptimizelargecallsexperimentalOptimizeLargeCallsbooleanOptionalWhether Daily’s experimental large-call optimization is requested.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-langlangstringOptionalLanguage code configured for the Daily room interface, such as en, es, or pt-BR.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-meetingjoinhookmeetingJoinHookstringOptionalWebhook URL invoked by the Daily meeting-join hook.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-geogeostringOptionalRegion selected for the Daily room media infrastructure, such as eu-west-2.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-rtmpgeortmpGeostringOptionalRegion selected for Daily RTMP streaming, such as us-west-2.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-disablertmpgeofallbackdisableRtmpGeoFallbackbooleanOptionalWhether automatic RTMP region fallback is disabled.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-recordingsbucketrecordingsBucketRecordingBucketConfigOptionalStorage destination configured for Daily recordings.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-transcriptionbuckettranscriptionBucketTranscriptionBucketConfigOptionalStorage destination configured for Daily transcriptions.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-recordingstemplaterecordingsTemplatestringOptionalTemplate used for recording object names in storage.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-field-transcriptiontemplatetranscriptionTemplatestringOptionalTemplate used for transcription object names in storage.

Values of enableRecording​

Section ID: DOC-API-MODEL-schema-1kp6t31pq7#request-values-enablerecording

Recording mode requested when configuring a Daily room.

ValueNo.FormMeaning
RECORDING_MODE_CLOUD0CanonicalSee meaning below.
RECORDING_MODE_LOCAL1CanonicalSee meaning below.
RECORDING_MODE_RAW_TRACKS2CanonicalSee meaning below.
RECORDING_MODE_DISABLED3CanonicalSee meaning below.

RECORDING_MODE_CLOUD

Request the provider's cloud recording mode.

"cloud"

RECORDING_MODE_LOCAL

Request the provider's local recording mode.

"local"

RECORDING_MODE_RAW_TRACKS

Request separate raw media tracks for recording.

"raw-tracks"

RECORDING_MODE_DISABLED

Explicitly disable room recording.

explicitly disabled

In responses​

Section ID: DOC-API-MODEL-schema-1kp6t31pq7#response

API JSON uses JSON field names (camelCase).

FieldTypePresenceMeaning
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-nbfSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-nbfnbfstring (int64)OptionalEarliest time at which the Daily room can be joined, as Unix seconds. Pattern: ^-?\d+$.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-expSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-expexpstring (int64)OptionalExpiration time of the Daily room, as Unix seconds. Pattern: ^-?\d+$.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-maxparticipantsSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-maxparticipantsmaxParticipantsstring (int64)OptionalMaximum number of participants allowed in the Daily room. Pattern: ^-?\d+$.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enablepeopleuiSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enablepeopleuienablePeopleUibooleanOptionalWhether the Daily room exposes participant-list controls.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enablepipuiSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enablepipuienablePipUibooleanOptionalWhether the Daily room enables picture-in-picture controls.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enableemojireactionsSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enableemojireactionsenableEmojiReactionsbooleanOptionalWhether the Daily room enables emoji reactions.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enablehandraisingSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enablehandraisingenableHandRaisingbooleanOptionalWhether the Daily room enables hand-raising controls.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enableprejoinuiSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enableprejoinuienablePrejoinUibooleanOptionalWhether the Daily room enables its prejoin screen.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enablelivecaptionsuiSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enablelivecaptionsuienableLiveCaptionsUibooleanOptionalWhether the Daily room exposes live-caption controls.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enablenetworkuiSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enablenetworkuienableNetworkUibooleanOptionalWhether the Daily room exposes network-information controls.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enablenoisecancellationuiSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enablenoisecancellationuienableNoiseCancellationUibooleanOptionalWhether the Daily room exposes noise-cancellation controls.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enablebreakoutroomsSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enablebreakoutroomsenableBreakoutRoomsbooleanOptionalWhether the Daily room enables breakout rooms.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enableknockingSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enableknockingenableKnockingbooleanOptionalWhen true, requests Daily’s knocking feature for a private room, allowing a participant without a meeting token to ask a meeting owner for admission. It does not restrict a public room. The current room-property mapping forwards true only; false or omission does not explicitly disable a provider setting.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-owneronlybroadcastSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-owneronlybroadcastownerOnlyBroadcastbooleanOptionalWhether broadcasting is restricted to Daily room owners.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enforceuniqueuseridsSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enforceuniqueuseridsenforceUniqueUserIdsbooleanOptionalWhether the Daily room requires participant user identifiers to be unique.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enablescreenshareSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enablescreenshareenableScreensharebooleanOptionalWhether screen sharing is enabled in the Daily room.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enablevideoprocessinguiSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enablevideoprocessinguienableVideoProcessingUibooleanOptionalWhether the Daily room exposes video-processing controls.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enablechatSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enablechatenableChatbooleanOptionalWhether chat is enabled in the Daily room.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enablesharedchathistorySection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enablesharedchathistoryenableSharedChatHistorybooleanOptionalWhether the Daily room enables shared chat history.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enableadvancedchatSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enableadvancedchatenableAdvancedChatbooleanOptionalWhether the Daily room enables advanced chat features.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enablehiddenparticipantsSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enablehiddenparticipantsenableHiddenParticipantsbooleanOptionalWhether the Daily room allows hidden participants.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-startvideooffSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-startvideooffstartVideoOffbooleanOptionalWhether participants join the Daily room with video initially off.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-startaudiooffSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-startaudiooffstartAudioOffbooleanOptionalWhether participants join the Daily room with audio initially off.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enablerecordingSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enablerecordingenableRecordingstring (RECORDING_MODE_CLOUD, RECORDING_MODE_LOCAL, RECORDING_MODE_RAW_TRACKS, RECORDING_MODE_DISABLED) or integer (int32)Optional; explicit presenceRecording mode configured for the Daily room.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-ejectatroomexpSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-ejectatroomexpejectAtRoomExpbooleanOptionalWhether participants are removed when the Daily room expires.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-ejectafterelapsedSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-ejectafterelapsedejectAfterElapsedstring (int64)OptionalElapsed session duration after which participants are removed, in seconds. Pattern: ^-?\d+$.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enablemeshsfuSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enablemeshsfuenableMeshSfubooleanOptionalWhen true, forwards Daily’s enable_mesh_sfu room-topology option. Confirm provider support and its effect for your Daily account before relying on it. The current room-property mapping forwards true only; false or omission does not explicitly disable a provider setting.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-sfuswitchoverSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-sfuswitchoversfuSwitchovernumber (double) or string (NaN, Infinity, -Infinity)OptionalDaily topology setting controlling the switch to SFU transport.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enableadaptivesimulcastSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enableadaptivesimulcastenableAdaptiveSimulcastbooleanOptionalWhether adaptive simulcast is enabled for the Daily room.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-enablemultipartyadaptivesimulcastSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-enablemultipartyadaptivesimulcastenableMultipartyAdaptiveSimulcastbooleanOptionalWhether multiparty adaptive simulcast is enabled for the Daily room.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-experimentaloptimizelargecallsSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-experimentaloptimizelargecallsexperimentalOptimizeLargeCallsbooleanOptionalWhether Daily’s experimental large-call optimization is requested.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-langSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-langlangstringOptionalLanguage code configured for the Daily room interface, such as en, es, or pt-BR.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-meetingjoinhookSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-meetingjoinhookmeetingJoinHookstringOptionalWebhook URL invoked by the Daily meeting-join hook.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-geoSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-geogeostringOptionalRegion selected for the Daily room media infrastructure, such as eu-west-2.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-rtmpgeoSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-rtmpgeortmpGeostringOptionalRegion selected for Daily RTMP streaming, such as us-west-2.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-disablertmpgeofallbackSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-disablertmpgeofallbackdisableRtmpGeoFallbackbooleanOptionalWhether automatic RTMP region fallback is disabled.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-recordingsbucketSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-recordingsbucketrecordingsBucketRecordingBucketConfigOptionalStorage destination configured for Daily recordings.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-transcriptionbucketSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-transcriptionbuckettranscriptionBucketTranscriptionBucketConfigOptionalStorage destination configured for Daily transcriptions.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-recordingstemplateSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-recordingstemplaterecordingsTemplatestringOptionalTemplate used for recording object names in storage.
Section ID: DOC-API-MODEL-schema-1kp6t31pq7#field-transcriptiontemplateSection ID: DOC-API-MODEL-schema-1kp6t31pq7#response-field-transcriptiontemplatetranscriptionTemplatestringOptionalTemplate used for transcription object names in storage.

Values of enableRecording​

Section ID: DOC-API-MODEL-schema-1kp6t31pq7#response-values-enablerecording

Recording mode requested when configuring a Daily room.

ValueNo.FormMeaning
RECORDING_MODE_CLOUD0CanonicalSee meaning below.
RECORDING_MODE_LOCAL1CanonicalSee meaning below.
RECORDING_MODE_RAW_TRACKS2CanonicalSee meaning below.
RECORDING_MODE_DISABLED3CanonicalSee meaning below.

RECORDING_MODE_CLOUD

Request the provider's cloud recording mode.

"cloud"

RECORDING_MODE_LOCAL

Request the provider's local recording mode.

"local"

RECORDING_MODE_RAW_TRACKS

Request separate raw media tracks for recording.

"raw-tracks"

RECORDING_MODE_DISABLED

Explicitly disable room recording.

explicitly disabled

Where used​

Section ID: DOC-API-MODEL-schema-1kp6t31pq7#where-used

ReferenceRelationship
Create a voice session (in progress)POST /api/v1/llm/create-daily-session
Models containing this value
ModelRelationship
DailySessionNested in model

Download the public reference contract.

Document ID: DOC-API-MODEL-schema-1kp6t31pq7