Skip to content
Tilecast Docs

previewSchedule

POST
/api/v1/schedules/preview
curl --request POST \
  --url https://example.com/api/v1/schedules/preview \
  --header 'Content-Type: application/json' \
  --data '{ "screenId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "timestamp": "2026-04-15T12:00:00Z", "proposedSchedule": { "name": "example", "description": "example", "playlistId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "layoutId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "displayAction": { "type": "display_power_on", "input": "example", "volume": 1, "brightness": 1 }, "type": "one_time", "timezone": "example", "priority": 1, "enabled": true, "startDate": "2026-04-15", "endDate": "2026-04-15", "oneTimeStart": "2026-04-15T12:00:00Z", "oneTimeEnd": "2026-04-15T12:00:00Z", "dailyStart": "example", "dailyEnd": "example", "daysOfWeek": [ 1 ], "targets": [ { "type": "screen", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "name": "example" } ] } }'

Preview schedule. Requires an authenticated dashboard user.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
screenId
required
string format: uuid
timestamp
string format: date-time
proposedSchedule
object
name
required
string
description
string
playlistId
string format: uuid
layoutId
string format: uuid
displayAction

A bounded Display Control action. A schedule may contain one action instead of a playlist or Layout. The server validates that only the field belonging to the selected type is present.

object
type
required
string
Allowed values: display_power_on display_power_off display_set_input display_set_volume display_mute display_unmute display_set_brightness
input
string
/^[A-Za-z0-9._:-]{1,32}$/
volume
integer
<= 100
brightness
integer
<= 100
type
required
string
Allowed values: one_time weekly
timezone
required
string
priority
required
integer
enabled
required
boolean
startDate
string | null format: date
endDate
string | null format: date
oneTimeStart
string | null format: date-time
oneTimeEnd
string | null format: date-time
dailyStart
string | null
dailyEnd
string | null
daysOfWeek
Array<integer>
targets
required
Array<object>
object
type
required
string
Allowed values: screen group
id
required
string format: uuid
name
string

Responses

Section titled “ Responses ”

200

Section titled “200”

Production resolution result, conflicts, fallback, and next transition

Media typeapplication/json
object
data
required
object
screenId
required
string format: uuid
at
required
string format: date-time
winningSchedule
object
id
required
string format: uuid
name
required
string
description
required
string
playlistId
string format: uuid
playlistName
required
string
layoutId
string format: uuid
layoutName
string
presentationType
required
string
Allowed values: playlist layout display_control
type
required
string
Allowed values: one_time weekly
timezone
required
string
priority
required
integer
>= -999 <= 999
specificity
required
integer
enabled
required
boolean
startDate
string format: date
endDate
string format: date
oneTimeStart
string format: date-time
oneTimeEnd
string format: date-time
dailyStart
string
dailyEnd
string
daysOfWeek
required
Array<integer>
displayAction

A bounded Display Control action. A schedule may contain one action instead of a playlist or Layout. The server validates that only the field belonging to the selected type is present.

object
type
required
string
Allowed values: display_power_on display_power_off display_set_input display_set_volume display_mute display_unmute display_set_brightness
input
string
/^[A-Za-z0-9._:-]{1,32}$/
volume
integer
<= 100
brightness
integer
<= 100
targets
required
Array<object>
object
type
required
string
Allowed values: screen group
id
required
string format: uuid
name
string
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
winningPlaylistId
string format: uuid
directFallbackPlaylistId
string format: uuid
applicableSchedules
required
Array<object>
object
id
required
string format: uuid
name
required
string
description
required
string
playlistId
string format: uuid
playlistName
required
string
layoutId
string format: uuid
layoutName
string
presentationType
required
string
Allowed values: playlist layout display_control
type
required
string
Allowed values: one_time weekly
timezone
required
string
priority
required
integer
>= -999 <= 999
specificity
required
integer
enabled
required
boolean
startDate
string format: date
endDate
string format: date
oneTimeStart
string format: date-time
oneTimeEnd
string format: date-time
dailyStart
string
dailyEnd
string
daysOfWeek
required
Array<integer>
displayAction

A bounded Display Control action. A schedule may contain one action instead of a playlist or Layout. The server validates that only the field belonging to the selected type is present.

object
type
required
string
Allowed values: display_power_on display_power_off display_set_input display_set_volume display_mute display_unmute display_set_brightness
input
string
/^[A-Za-z0-9._:-]{1,32}$/
volume
integer
<= 100
brightness
integer
<= 100
targets
required
Array<object>
object
type
required
string
Allowed values: screen group
id
required
string format: uuid
name
string
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
nextTransition
string format: date-time
conflicts
required
Array<string>
Example
{
  "data": {
    "winningSchedule": {
      "presentationType": "playlist",
      "type": "one_time",
      "displayAction": {
        "type": "display_power_on"
      },
      "targets": [
        {
          "type": "screen"
        }
      ]
    },
    "applicableSchedules": [
      {
        "presentationType": "playlist",
        "type": "one_time",
        "displayAction": {
          "type": "display_power_on"
        },
        "targets": [
          {
            "type": "screen"
          }
        ]
      }
    ]
  }
}

403

Section titled “403”

Scheduling access required