Skip to main content

View a list of room compositions.

GET 
/room_compositions

Request​

Query Parameters

    filter[date_created_at][eq] date

    ISO 8601 date for filtering room compositions created on that date.

    filter[date_created_at][gte] date

    ISO 8601 date for filtering room compositions created after that date.

    filter[date_created_at][lte] date

    ISO 8601 date for filtering room compositions created before that date.

    filter[session_id] uuid

    The session_id for filtering room compositions.

    filter[status] string

    Possible values: [completed, processing, enqueued]

    The status for filtering room compositions.

    page[size] integer

    Possible values: >= 1 and <= 250

    Default value: 20

    The size of the page.

    page[number] integer

    Possible values: >= 1

    Default value: 1

    The page number to load.

Responses​

200: List room compositions response.

Schema

    data

    object[]

  • Array [

    • id uuid

    A unique identifier for the room composition.

    room_id uuid

    Identify the room associated with the room composition.

    session_id uuid

    Identify the room session associated with the room composition.

    user_id uuid

    Identify the user associated with the room composition.

    status string

    Possible values: [completed, enqueued, processing]

    Shows the room composition status.

    size_mb float

    Shows the room composition size in MB.

    download_url string

    Url to download the composition.

    duration_secs integer

    Shows the room composition duration in seconds.

    format string

    Possible values: [mp4]

    Shows format of the room composition.

    created_at datetime

    ISO 8601 timestamp when the room composition was created.

    updated_at datetime

    ISO 8601 timestamp when the room composition was updated.

    ended_at datetime

    ISO 8601 timestamp when the room composition has ended.

    started_at datetime

    ISO 8601 timestamp when the room composition has stated.

    completed_at datetime

    ISO 8601 timestamp when the room composition has completed.

    video_layout

    object

    Describes the video layout of the room composition in terms of regions. Limited to 2 regions.

    property name*

    VideoRegion

    x_pos integernullable

    Default value: 0

    X axis value (in pixels) of the region's upper left corner relative to the upper left corner of the whole room composition viewport.

    y_pos integernullable

    Default value: 0

    Y axis value (in pixels) of the region's upper left corner relative to the upper left corner of the whole room composition viewport.

    z_pos integernullable

    Possible values: >= -99 and <= 99

    Default value: 0

    Regions with higher z_pos values are stacked on top of regions with lower z_pos values

    height integernullable

    Possible values: >= 16

    Height of the video region

    width integernullable

    Possible values: >= 16

    Width of the video region

    max_columns integernullable

    Possible values: >= 1 and <= 1000

    Maximum number of columns of the region's placement grid. By default, the region has as many columns as needed to layout all the specified video sources.

    max_rows integernullable

    Possible values: >= 1 and <= 1000

    Maximum number of rows of the region's placement grid. By default, the region has as many rows as needed to layout all the specified video sources.

    video_sources uuid[]

    Array of video recording ids to be composed in the region. Can be "*" to specify all video recordings in the session

    Describes the video layout of the room composition in terms of regions. Limited to 2 regions.

    webhook_event_url url

    The URL where webhooks related to this room composition will be sent. Must include a scheme, such as 'https'.

    webhook_event_failover_url urlnullable

    The failover URL where webhooks related to this room composition will be sent if sending to the primary URL fails. Must include a scheme, such as 'https'.

    webhook_timeout_secs integernullable

    Possible values: <= 30

    Specifies how many seconds to wait before timing out a webhook.

    record_type string

  • ]

    • meta

    object

    page_number integer
    page_size integer
    total_pages integer
    total_results integer
Loading...