> This page is for APIs.

> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# layout.changed

GET /

Receive layout-changed events

Reference: https://signalwire.com/docs/apis/relay/client/fabric/layout-changed

## AsyncAPI Specification

```yaml
asyncapi: 2.6.0
info:
  title: layout.changed
  version: subpackage_layoutChanged.layout.changed
  description: Receive layout-changed events
channels:
  /:
    description: Receive layout-changed events
    publish:
      operationId: subpackage_layoutChanged.layout.changed-publish
      summary: layout.changed
      message:
        name: onLayoutChangedLayoutChangedEvent
        title: layout.changed
        payload:
          $ref: '#/components/schemas/layout.changed_layoutChangedEvent'
servers:
  production:
    url: wss://relay.signalwire.com/
    protocol: wss
    x-default: true
components:
  schemas:
    ChannelsLayoutChangedMessagesLayoutChangedEventJsonrpc:
      type: string
      enum:
        - '2.0'
      description: JSON-RPC version. Always `2.0`.
      title: ChannelsLayoutChangedMessagesLayoutChangedEventJsonrpc
    ChannelsLayoutChangedMessagesLayoutChangedEventMethod:
      type: string
      enum:
        - signalwire.event
      description: Always `signalwire.event`.
      title: ChannelsLayoutChangedMessagesLayoutChangedEventMethod
    ChannelsLayoutChangedMessagesLayoutChangedEventParamsEventType:
      type: string
      enum:
        - layout.changed
      description: The event type — identifies which event this is.
      title: ChannelsLayoutChangedMessagesLayoutChangedEventParamsEventType
    Fabric.LayoutLayer:
      type: object
      properties:
        layer_index:
          type: integer
          description: The layer's index in the layout.
        z_index:
          type: integer
          description: The layer's z-index (stacking order).
        member_id:
          type: string
          description: The member shown in this layer, when one is assigned.
        playing_file:
          type: boolean
          description: Whether this layer is playing a file rather than showing a member.
        position:
          type: string
          description: The named position this layer occupies, such as `standard-1`.
        reservation:
          type: string
          description: The reservation name for this layer, when reserved.
        visible:
          type: boolean
          description: Whether this layer is currently visible.
        x:
          type: integer
          description: The layer's horizontal offset, as a percentage of the frame.
        'y':
          type: integer
          description: The layer's vertical offset, as a percentage of the frame.
        width:
          type: integer
          description: The layer's width, as a percentage of the frame.
        height:
          type: integer
          description: The layer's height, as a percentage of the frame.
      required:
        - layer_index
        - z_index
        - playing_file
        - position
        - visible
        - x
        - 'y'
        - width
        - height
      description: >-
        One layer of a Call Fabric video layout — a positioned region that can
        show a member's video or a played file.
      title: Fabric.LayoutLayer
    Fabric.LayoutInfo:
      type: object
      properties:
        room_id:
          type: string
          description: The room ID.
        room_session_id:
          type: string
          description: The room session ID.
        name:
          type: string
          description: The layout's name, such as `grid-responsive`.
        layers:
          type: array
          items:
            $ref: '#/components/schemas/Fabric.LayoutLayer'
          description: The layout's layers.
      required:
        - room_id
        - room_session_id
        - name
        - layers
      description: A Call Fabric video layout, as delivered on the `layout.changed` event.
      title: Fabric.LayoutInfo
    Fabric.LayoutChangedParams:
      type: object
      properties:
        room_id:
          type: string
          description: The room ID.
        room_session_id:
          type: string
          description: The room session ID.
        layout:
          $ref: '#/components/schemas/Fabric.LayoutInfo'
          description: The layout now in effect.
      required:
        - room_id
        - room_session_id
        - layout
      description: 'Payload of the `layout.changed` event: the new video layout in effect.'
      title: Fabric.LayoutChangedParams
    ChannelsLayoutChangedMessagesLayoutChangedEventParams:
      type: object
      properties:
        event_type:
          $ref: >-
            #/components/schemas/ChannelsLayoutChangedMessagesLayoutChangedEventParamsEventType
          description: The event type — identifies which event this is.
        event_channel:
          type: string
          description: >-
            The channel the event was delivered on — for Calling events, the
            `protocol`

            string your connection received from `signalwire.connect`.
        timestamp:
          type: number
          format: double
          description: >-
            When the event was emitted, as a Unix timestamp in seconds. Always
            present.
        project_id:
          type: string
          description: >-
            Your project ID. Present on Calling events and most Call Fabric
            events; absent on `call.joined`, `call.left`, `member.joined`, and
            `member.left`.
        space_id:
          type: string
          description: >-
            Your space ID. Present on Calling events and most Call Fabric
            events; absent on `call.joined`, `call.left`, `member.joined`, and
            `member.left`.
        params:
          $ref: '#/components/schemas/Fabric.LayoutChangedParams'
          description: The event-specific payload.
      required:
        - event_type
        - event_channel
        - timestamp
        - params
      description: The event envelope.
      title: ChannelsLayoutChangedMessagesLayoutChangedEventParams
    layout.changed_layoutChangedEvent:
      type: object
      properties:
        jsonrpc:
          $ref: >-
            #/components/schemas/ChannelsLayoutChangedMessagesLayoutChangedEventJsonrpc
          description: JSON-RPC version. Always `2.0`.
        id:
          type: string
          description: >-
            Event id — a unique UUID generated for each event. Events are
            notifications: you do not reply to them.
        method:
          $ref: >-
            #/components/schemas/ChannelsLayoutChangedMessagesLayoutChangedEventMethod
          description: Always `signalwire.event`.
        params:
          $ref: >-
            #/components/schemas/ChannelsLayoutChangedMessagesLayoutChangedEventParams
          description: The event envelope.
      required:
        - jsonrpc
        - id
        - method
        - params
      description: >-
        Fires when the video layout changes, for example after
        `call.layout.set`. Delivers the new layout. Note the wire event type is
        `layout.changed`, not `call.layout.changed`.
      title: layout.changed_layoutChangedEvent

```