Skip to content
Tilecast Docs

updateLayout

PATCH
/api/v1/layouts/{id}
curl --request PATCH \
  --url https://example.com/api/v1/layouts/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Content-Type: application/json' \
  --cookie tilecast_session=<tilecast_session> \
  --data '{ "name": "example", "description": "example" }'

Update layout. Requires an authenticated dashboard user.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
id
required
string format: uuid

Header Parameters

Section titled “Header Parameters”
X-CSRF-Token
string

Cookie-backed browser requests only, and only on unsafe methods. Bearer grants never send it.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
name
required
string
>= 1 characters <= 180 characters
description
string
<= 2000 characters
Examplegenerated
{
  "name": "example",
  "description": "example"
}

Responses

Section titled “ Responses ”

200

Section titled “200”

Layout metadata updated

Media typeapplication/json
object
data
required
object
id
required
string format: uuid
name
required
string
description
required
string
orientation
required
string
Allowed values: landscape portrait custom
canvasWidth
required
integer
>= 320 <= 7680
canvasHeight
required
integer
>= 320 <= 7680
draft
required
object
schemaVersion
required

Only schema version 2 is accepted.

integer
Allowed values: 2
canvas
required
object
width
required
integer
>= 320 <= 7680
height
required
integer
>= 320 <= 7680
orientation
required
string
Allowed values: landscape portrait custom
backgroundColor
required
string
backgroundAssetId
string format: uuid
backgroundVariantId
string format: uuid
safeAreaPercent
required
number
<= 20
placements
required
Array<object>
<= 200 items
object
id
required
string format: uuid
type
required
string
Allowed values: widget asset playlistZone primitive
name
required
string
x
required
number
y
required
number
width
required
number
height
required
number
layer
required
integer
<= 999
opacity
required
number
<= 1
visible
required
boolean
locked
required
boolean
groupId
string format: uuid
widgetId
string format: uuid
assetId
string format: uuid
variantId
string format: uuid
playlistId
string format: uuid
overrides

Legacy Widget placement override bag. The listed values are accepted for saved-document compatibility but are ignored by Studio and Player.

object
fit
string
Allowed values: contain cover stretch
alignment
string
Allowed values: left center right
foregroundColor
string
backgroundColor
string
fallbackVisibility
string
Allowed values: show hide
muted
boolean
primitive
object
kind
required
string
Allowed values: text rectangle circle line group
text
string
<= 4000 characters
fontFamily

Only bundled fonts are accepted for text primitives

string
Allowed values: Inter Roboto Source Sans 3 Noto Sans
fontId

A family from the organization font library. fontFamily stays the bundled fallback

string format: uuid
fontSize
number
>= 8 <= 600
fontWeight
integer
Allowed values: 400 500 600 700 800
textAlign
string
Allowed values: left center right
verticalAlign
string
Allowed values: top center bottom
color
string
backgroundColor
string
lineHeight
number
letterSpacing
number
padding
number
borderWidth
number
borderColor
string
cornerRadius
number
maximumLines
integer
>= 1
overflow
string
Allowed values: clip ellipsis
autoFit
boolean
minimumFontSize
number
fillColor
string
strokeColor
string
strokeWidth
number
binding
object
dataSourceId
required
string format: uuid
field
required
string
>= 1 characters
prefix
string
<= 500 characters
suffix
string
<= 500 characters
fallbackText
string
<= 500 characters
hideWhenEmpty
boolean
format
string
Allowed values: text date-short date-long number integer currency
playback
object
fit
string
Allowed values: contain cover stretch
muted
boolean
loop
boolean
fallback
string
Allowed values: hide background previous
cornerRadius
number
<= 1000
draftRevision
required
integer format: int64
publishedRevisionId
string format: uuid
publishedRevision
integer format: int64
publishedAt
string format: date-time
hasUnpublishedChanges
required
boolean
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
previewImageUrl
string
previewCaptureVersion
integer
>= 1
dependencies
required
Array<object>
object
type
required
string
Allowed values: widget asset playlist data_source
id
required
string format: uuid
usage
required
object
screens
required
Array<object>
object
id
required
string format: uuid
name
required
string
schedules
required
Array<object>
object
id
required
string format: uuid
name
required
string
campaigns
required
Array<object>
object
id
required
string format: uuid
name
required
string
Example
{
  "data": {
    "orientation": "landscape",
    "draft": {
      "schemaVersion": 2,
      "canvas": {
        "orientation": "landscape"
      },
      "placements": [
        {
          "type": "widget",
          "overrides": {
            "fit": "contain",
            "alignment": "left",
            "fallbackVisibility": "show"
          },
          "primitive": {
            "kind": "text",
            "fontFamily": "Inter",
            "fontWeight": 400,
            "textAlign": "left",
            "verticalAlign": "top",
            "overflow": "clip",
            "binding": {
              "format": "text"
            }
          },
          "playback": {
            "fit": "contain",
            "fallback": "hide"
          }
        }
      ]
    },
    "dependencies": [
      {
        "type": "widget"
      }
    ]
  }
}

401

Section titled “401”

Dashboard authentication required