Skip to main content

List Room Sessions



A list of past and in-progress Room Sessions.


The API token must include the following scopes: Video.


Query Parameters

    room_id uuid

    Return Sessions started from this Room.

    Example: fe4093d9-58c2-4931-b4b9-5679f82652c6
    room_name string

    Return Sessions with a matching room name.

    Example: my_example_room
    status string

    Return Sessions currently in this state. Possible values are: completed and in-progress.

    Example: completed






    self string
    first string
    next string
    prev string



  • Array [

  • id uuid

    Unique ID of the session

    room_id uuid

    Unique ID of the Room if the Session was created from a Room and was not an auto-created Session.

    name string

    The named identifier of room session.

    display_name string

    Display name of room, no character limitations. Maxium of 200 characters. Defaults to the value of name.

    join_from date-time

    Room Session does not accept new Members before this time.

    join_until date-time

    Room Session stops accepting new Members at this time.

    remove_at date-time

    Remove Members from the Room Session at this time.

    remove_after_seconds_elapsed int32

    Remove Members after they are in the Room Session for N seconds.

    layout string

    The Room Session's initial layout. Defaults to grid-responsive. See documentation for a full list of supported layouts.

    max_members integer

    The maximum number of members allowed in the room at a time.

    fps integer

    The Room Session's frames per second. Possible values are 20 or 30.

    quality string

    The Room Session's resolution. Possible values are 720p or 1080p.

    start_time date-time
    end_time date-time
    duration integer

    How long, in seconds, the Room Session lasted.

    status string
    record_on_start boolean

    Whether a recording was automatically started when this Room Session began.

    enable_room_previews boolean

    Whether a video with a preview of the content of the room is to be generated.

    preview_url string

    If room previews are enabled and the room session is in progress, this is the URL of the preview video.

    audio_video_sync boolean

    Enable/disable jitter buffer audio-video sync.

  • ]