v51

latestOpenAPI 3.0.0AGPLv3 or laterraw.githubusercontent.com2026-08-0126276829.1 KB

layout

Checkout Layout

Checkout a Layout so that it can be edited. The original Layout will still be played

put/layout/checkout/{layoutId}

Path parameters

layoutIdinteger required

The Layout ID

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