Sign in
layout

Search Layouts

Search for Layouts viewable by this user

get/layout

Query parameters

layoutIdinteger

Filter by Layout Id

parentIdinteger

Filter by parent Id

showDraftsinteger

Flag indicating whether to show drafts

layoutstring

Filter by partial Layout name

userIdinteger

Filter by user Id

retiredinteger

Filter by retired flag

tagsstring

Filter by Tags

exactTagsinteger

A flag indicating whether to treat the tags filter as an exact match

logicalOperatorstring

When filtering by multiple Tags, which logical operator should be used? AND|OR

ownerUserGroupIdinteger

Filter by users in this UserGroupId

publishedStatusIdinteger

Filter by published status id, 1 - Published, 2 - Draft

embedstring

Embed related data such as regions, playlists, widgets, tags, campaigns, permissions

campaignIdinteger

Get all Layouts for a given campaignId

folderIdinteger

Filter by Folder ID

sortBy'layoutId' | 'layout' | 'publishedStatus' | 'enableStat' | 'duration' | 'owner' | 'modifiedDt' | 'campaignId' | 'groupsWithPermissions'

Specifies which field the results are sorted by. Used together with sortDir

sortDir'asc' | 'desc'

Sort direction

Response

successful operation

layoutIdinteger

The layoutId

ownerIdinteger

The userId of the Layout Owner

campaignIdinteger

The id of the Layout's dedicated Campaign

parentIdinteger

The parentId, if this Layout has a draft

publishedStatusIdinteger

The Status Id

publishedStatusstring

The Published Status (Published, Draft or Pending Approval

publishedDatestring

The Published Date

backgroundImageIdinteger

The id of the image media set as the background

schemaVersioninteger

The XLF schema version

layoutstring

The name of the Layout

descriptionstring

The description of the Layout

backgroundColorstring

A HEX string representing the Layout background color

createdDtstring

The datetime the Layout was created

modifiedDtstring

The datetime the Layout was last modified

statusinteger

Flag indicating the Layout status

retiredinteger

Flag indicating whether the Layout is retired

backgroundzIndexinteger

The Layer that the background should occupy

widthnumber double

The Layout Width

heightnumber double

The Layout Height

orientationstring

The Layout Orientation

displayOrderinteger

If this Layout has been requested by Campaign, then this is the display order of the Layout within the Campaign

durationinteger

A read-only estimate of this Layout's total duration in seconds. This is equal to the longest region duration and is valid when the layout status is 1 or 2.

statusMessagestring

A status message detailing any errors with the layout

enableStatinteger

Flag indicating whether the Layout stat is enabled

autoApplyTransitionsinteger

Flag indicating whether the default transitions should be applied to this Layout

codestring

Code identifier for this Layout

isLockedboolean

Is this layout locked by another user?

folderIdinteger

The id of the Folder this Layout belongs to

permissionsFolderIdinteger

The id of the Folder responsible for providing permissions for this Layout

Changes

Changed in 5 of the 52 revisions of this API.125

  • fe497e811c7f2See the full diff
    • ○

      added the new optional query request parameter sortBy

      new-optional-request-parameter

    • ○

      added the new optional query request parameter sortDir

      new-optional-request-parameter

  • 41c04de98ec51See the full diff
    • ○

      added the media type application/json for the response with the status 200

      response-media-type-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 6d18f62f77821See the full diff
    • ○

      added the new optional query request parameter logicalOperator

      new-optional-request-parameter

  • 9ddbdc81e86a1See the full diff
    • ○

      added the new optional query request parameter folderId

      new-optional-request-parameter

  • 8e127539510412See the full diff
    • ▲

      removed the media type application/json for the response with the status 200

      response-media-type-removed

    • ●

      deleted the query request parameter folderId

      request-parameter-removed

    • ●

      deleted the query request parameter logicalOperator

      request-parameter-removed

    This revision also has 77 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog