DailyRESTHelper

Daily REST API Documentation

For complete Daily REST API reference and additional details

Classes

DailyRoomSipParams

Configuration for SIP (Session Initiation Protocol) parameters.

string

default:"sw-sip-dialin"

Display name for the SIP endpoint

boolean

default:false

Whether video is enabled for SIP

string

default:"dial-in"

SIP connection mode

integer

default:1

Number of SIP endpoints

from pipecat.transports.daily.utils import DailyRoomSipParams

sip_params = DailyRoomSipParams(
    display_name="conference-line",
    video=True,
    num_endpoints=2
)

RecordingsBucketConfig

Configuration for storing Daily recordings in a custom S3 bucket.

string

required

Name of the S3 bucket for storing recordings

string

required

AWS region where the S3 bucket is located

string

required

ARN of the IAM role to assume for S3 access

boolean

default:false

Whether to allow API access to the recordings

from pipecat.transports.daily.utils import RecordingsBucketConfig

bucket_config = RecordingsBucketConfig(
    bucket_name="my-recordings-bucket",
    bucket_region="us-west-2",
    assume_role_arn="arn:aws:iam::123456789012:role/DailyRecordingsRole",
    allow_api_access=True
)

DailyRoomProperties

Properties that configure a Daily room’s behavior and features.

float

Room expiration time as Unix timestamp (e.g., time.time() + 300 for 5 minutes)

boolean

default:false

Whether chat is enabled in the room

boolean

default:false

Whether the prejoin lobby UI is enabled

boolean

default:false

Whether emoji reactions are enabled

boolean

default:false

Whether to eject participants when room expires

boolean

Whether dial-out is enabled

string

Recording settings (“cloud”, “cloud-audio-only”, “local”, or “raw-tracks”)

string

Geographic region for room

number

Maximum number of participants allowed in the room

RecordingsBucketConfig

Configuration for custom S3 bucket recordings

DailyRoomSipParams

SIP configuration parameters

dict

SIP URI configuration (returned by Daily)

boolean

default:false

Whether the camera video is turned off by default

The class also includes a sip_endpoint property that returns the SIP endpoint URI if available. enable_recording also supports cloud-audio-only, which records the call server-side and produces an audio-only MPEG-4 file with .m4a file extension and content type as audio/mp4. This recording setting behaves like cloud, except the layout options do not apply because there are no video tracks. Note: you can retrieve the resulting .m4a recordings via the Daily REST API, in the same way you fetch cloud recording assets.

If you’re already using enable_recording="cloud" and want to switch to audio-only without changing your code, you can set force_audio_only_recording: 1 on your Daily domain. This forces all cloud recordings to be audio-only (.m4a instead of .mp4) and skips recording video tracks even if they are present. This is useful when you want to transition to audio-only recordings immediately while avoiding an application redeploy. Switching force_audio_only_recording: 0 will allow recording video tracks.

import time
from pipecat.transports.daily.utils import (
    DailyRoomProperties,
    DailyRoomSipParams,
    RecordingsBucketConfig,
)

properties = DailyRoomProperties(
    exp=time.time() + 3600,  # 1 hour from now
    enable_chat=True,
    enable_emoji_reactions=True,
    enable_recording="cloud-audio-only",
    geo="us-west",
    max_participants=50,
    sip=DailyRoomSipParams(display_name="conference"),
    recordings_bucket=RecordingsBucketConfig(
        bucket_name="my-bucket",
        bucket_region="us-west-2",
        assume_role_arn="arn:aws:iam::123456789012:role/DailyRole"
    )
)

# Access SIP endpoint if available
if properties.sip_endpoint:
    print(f"SIP endpoint: {properties.sip_endpoint}")

DailyRoomParams

Parameters for creating a new Daily room.

string

Room name (if not provided, one will be generated)

string

default:"public"

Room privacy setting (“private” or “public”)

DailyRoomProperties

Room configuration properties

import time
from pipecat.transports.daily.utils import (
    DailyRoomParams,
    DailyRoomProperties,
)

params = DailyRoomParams(
    name="team-meeting",
    privacy="private",
    properties=DailyRoomProperties(
        enable_chat=True,
        exp=time.time() + 7200  # 2 hours from now
    )
)

DailyRoomObject

Response object representing a Daily room.

string

Unique room identifier

string

Room name

boolean

Whether the room was created via API

string

Room privacy setting

string

Complete room URL

string

Room creation timestamp in ISO 8601 format

DailyRoomProperties

Room configuration

from pipecat.transports.daily.utils import (
    DailyRoomObject,
    DailyRoomProperties,
)

# Example of what a DailyRoomObject looks like when received
room = DailyRoomObject(
    id="abc123",
    name="team-meeting",
    api_created=True,
    privacy="private",
    url="https://your-domain.daily.co/team-meeting",
    created_at="2024-01-20T10:00:00.000Z",
    config=DailyRoomProperties(
        enable_chat=True,
        exp=1705743600
    )
)

DailyMeetingTokenProperties

Properties for configuring a Daily meeting token.

string

The room this token is valid for. If not set, token is valid for all rooms.

boolean

Whether to eject user when token expires

integer

Eject user after this many seconds

integer

“Not before” timestamp - users cannot join before this time

integer

Expiration timestamp - users cannot join after this time

boolean

Whether token grants owner privileges

string

User’s display name in the meeting

string

Unique identifier for the user (36 char limit)

boolean

Whether user can share their screen

boolean

Whether to join with video off

boolean

Whether to join with audio off

string

Recording settings (“cloud”, “cloud-audio-only”, “local”, or “raw-tracks”)

boolean

Whether to show prejoin UI

boolean

Whether to start cloud recording when user joins

dict

Initial default permissions for a non-meeting-owner participant

DailyMeetingTokenParams

Parameters for creating a Daily meeting token.

DailyMeetingTokenProperties

Token configuration properties

from pipecat.transports.daily.utils import (
    DailyMeetingTokenParams,
    DailyMeetingTokenProperties,
)

token_params = DailyMeetingTokenParams(
    properties=DailyMeetingTokenProperties(
        user_name="John Doe",
        enable_screenshare=True,
        start_video_off=True,
        enable_recording="cloud-audio-only",
        start_cloud_recording=True,
        permissions={"canSend": ["video", "audio"]}
    )
)

Recording type: cloud will produce files with a .mp4 extension, while cloud-audio-only will produce files with a .m4a extension.

Initialize DailyRESTHelper

Create a new instance of the Daily REST helper.

string

required

Your Daily API key

string

default:"https://api.daily.co/v1"

The Daily API base URL

aiohttp.ClientSession

required

An aiohttp client session for making HTTP requests

helper = DailyRESTHelper(
    daily_api_key="your-api-key",
    aiohttp_session=session
)

Create Room

Creates a new Daily room with specified parameters.

DailyRoomParams

required

Room configuration parameters including name, privacy, and properties

# Create a room that expires in 1 hour
params = DailyRoomParams(
    name="my-room",
    privacy="private",
    properties=DailyRoomProperties(
        exp=time.time() + 3600,
        enable_chat=True
    )
)
room = await helper.create_room(params)
print(f"Room URL: {room.url}")

Get Room From URL

Retrieves room information using a Daily room URL.

string

required

The complete Daily room URL

room = await helper.get_room_from_url("https://your-domain.daily.co/my-room")
print(f"Room name: {room.name}")

Get Token

Generates a meeting token for a specific room.

string

required

The complete Daily room URL

float

default:"3600"

Token expiration time in seconds

bool

default:"False"

Whether to eject user when token expires

bool

default:"True"

Whether the token should have owner privileges (overrides any setting in params)

DailyMeetingTokenParams

Additional token configuration. Note that room_name, exp, eject_at_token_exp, and is_owner will be set based on the other function parameters.

# Basic token generation
token = await helper.get_token(
    room_url="https://your-domain.daily.co/my-room",
    expiry_time=1800,  # 30 minutes
    owner=True,
    eject_at_token_exp=True
)

# Advanced token generation with additional properties
token_params = DailyMeetingTokenParams(
    properties=DailyMeetingTokenProperties(
        user_name="John Doe",
        start_video_off=True
    )
)
token = await helper.get_token(
    room_url="https://your-domain.daily.co/my-room",
    expiry_time=1800,
    owner=False,
    eject_at_token_exp=True,
    params=token_params
)

Delete Room By URL

Deletes a room using its URL.

string

required

The complete Daily room URL

success = await helper.delete_room_by_url("https://your-domain.daily.co/my-room")
if success:
    print("Room deleted successfully")

Delete Room By Name

Deletes a room using its name.

string

required

The name of the Daily room

success = await helper.delete_room_by_name("my-room")
if success:
    print("Room deleted successfully")

Get Name From URL

Extracts the room name from a Daily room URL.

string

required

The complete Daily room URL

room_name = helper.get_name_from_url("https://your-domain.daily.co/my-room")
print(f"Room name: {room_name}")  # Outputs: "my-room"

Pipecat Server

Client SDKs

Pipecat Flows

Pipecat Cloud

CLI

Pipecat Context Hub

DailyRESTHelper

Daily REST API Documentation

Classes

DailyRoomSipParams

RecordingsBucketConfig

DailyRoomProperties

DailyRoomParams

DailyRoomObject

DailyMeetingTokenProperties

DailyMeetingTokenParams

Initialize DailyRESTHelper

Create Room

Get Room From URL

Get Token

Delete Room By URL

Delete Room By Name

Get Name From URL

Daily REST API Documentation

​Classes

​DailyRoomSipParams

​RecordingsBucketConfig

​DailyRoomProperties

​DailyRoomParams

​DailyRoomObject

​DailyMeetingTokenProperties

​DailyMeetingTokenParams

​Initialize DailyRESTHelper

​Create Room

​Get Room From URL

​Get Token

​Delete Room By URL

​Delete Room By Name

​Get Name From URL

Classes

DailyRoomSipParams

RecordingsBucketConfig

DailyRoomProperties

DailyRoomParams

DailyRoomObject

DailyMeetingTokenProperties

DailyMeetingTokenParams

Initialize DailyRESTHelper

Create Room

Get Room From URL

Get Token

Delete Room By URL

Delete Room By Name

Get Name From URL