What a Schedule does
A Schedule plays an exact Ready Playlist version on a Channel at a specified time. After a timed window ends, the Channel returns to its default content.Before you start
Use the Postman setup. Setplatform_base to https://api.layarva.com/api/platform/v1/workspaces/YOUR_WORKSPACE_ID and use your Platform key as the Bearer token.
For POST, PATCH and DELETE, use Body → raw → JSON, Content-Type: application/json and a new Idempotency-Key for each new change. GET needs no body or operation key.
Permissions are schedules.read, schedules.create, schedules.update and schedules.delete as needed. Creating or updating also needs publications.execute and must follow your workspace’s publishing/approval rules.
Step 1: Prepare the Channel and scheduled content
- Choose a Channel with default Ready content to return to. A new Channel’s first manual publication sets this default if none exists.
- Prepare a different Playlist for the scheduled content using Playlist → Ready.
- Save the Channel ID as
channel_idand the scheduled Ready version ID asscheduled_version_id.
DRAFT instead of being enabled. Check your Channel with GET /channels/{{channel_id}}; defaultPlaylistVersionId identifies its default version.
Step 2: Create a weekly Schedule
Send POST{{platform_base}}/schedules:
0=Sunday, 1=Monday, through 6=Saturday.
A successful response is 201 Created. Save data.id as schedule_id. Check data.controlState; creation alone does not prove a device is playing the scheduled content.
Other timing types
For example, a one-time Schedule can use:
Step 3: List and check the Schedule
Send GET{{platform_base}}/schedules?channelId={{channel_id}}&limit=25.
Read one Schedule with GET {{platform_base}}/schedules/{{schedule_id}}. Save data.updatedAt as schedule_updated_at before editing.
DRAFT: not enabled; check default content and dependencies.ACTIVEorENABLED: enabled for execution, not necessarily playing at this moment.PAUSED: timing is retained but execution is paused.
controlState=ENABLED selects enabled Schedules, including records returned as ACTIVE. If available, lifecycleStatus describes timing separately from control state.
Check Screen playback to confirm delivery at the scheduled time.
Step 4: Edit, pause or resume
Read the Schedule first, then send PATCH{{platform_base}}/schedules/{{schedule_id}}:
weeklyWindows array when changing it. For a pause, the body can be just:
paused: false. Save the new updatedAt after every successful change. If there is a conflict, read the current Schedule and review it before retrying; do not reuse an outdated timestamp.
Step 5: Delete the Schedule
Send DELETE{{platform_base}}/schedules/{{schedule_id}} with {} and schedules.delete.
This removes future scheduled execution. It is not an immediate stop command for content already playing on a disconnected device. Campaign-managed Schedules must be managed through Layarva.
Keep the key and its issuing account authorized for future scheduled runs. Expired or revoked keys no longer authorize those runs. Use a suitable expiry or Never expire, and revoke keys you no longer need.

