Export published content through the API
Use the export and download endpoints to create a signed offline package from an eligible Screen’s published content. Follow the steps below to request the package, download it, verify it and import it into a compatible Player.If an export endpoint returns
503, stop the workflow. Do not repeatedly create jobs or poll an unavailable feature. Retry later when instructed, or export through the dashboard and contact support with the response requestId.Step 1: Prepare fixed content
- Create a Playlist using only content supported for offline playback.
- Set it as Ready and save the exact Ready version ID.
- Publish that version to the prepared Channel and confirm the Publication.
- Check offline eligibility in Layarva before exporting.
Step 2: Create the offline Screen
The simplest flow is Screens → Pair Screen → Offline content in Layarva. Enter a name, select the prepared Channel, optionally choose a Location, and configure display size/fit. If using the API, send POST/screens with screens.create:
acceptsPlanScreen: true; do not automatically opt in.
An offline-package Screen does not use a Cloud pairing code or device token.
Step 3: Request the package
Your Platform key needsscreens.offline-export. Send POST /screens/{{screen_id}}/offline-exports:
- Authorization: your Platform Bearer key.
- Headers:
Content-Type: application/jsonand a new Idempotency-Key. - Body → raw → JSON:
{}.
data.id as export_id. Layarva selects the Screen’s published content and permitted playback period; do not supply your own Publication ID, expiry or package contents.
An accepted request is not a finished download. Use the same initiating API key for the following status and download requests. That key must remain valid and authorized.
Step 4: Check package status
Send GET/offline-exports/{{export_id}} with your Platform Bearer key and no body:
Stop polling at the returned
expiresAt; do not poll indefinitely. READY confirms the package was built, not that a Player imported or played it. To list earlier exports created with this key, use GET /screens/{{screen_id}}/offline-exports?limit=25 and follow page.nextCursor.
Step 5: Download and verify the file
- Send GET
/offline-exports/{{export_id}}/downloadwith your Platform Bearer key. - Copy the returned
data.url. It is a temporary download URL valid for 60 seconds; keep it private. - In a separate Postman request, send GET to that complete URL. Select Authorization → No Auth, overriding inherited authentication. Do not send your Platform key or Idempotency-Key to this URL.
- Use Postman’s download/save response option to save the binary package as
.lvapkg, not JSON. If the URL expired, request a fresh one while the export and playback lease remain valid. - Compare the saved file’s exact byte size and SHA-256 with the values from step 4 before importing.
Dashboard alternative
- Open the offline Screen’s actions.
- Choose Export offline package.
- Review the Channel lock and playback expiry shown in the confirmation.
- Confirm and save the downloaded
.lvapkgpackage.
Step 6: Import into the Player
Transfer the package to a supported Layarva Player and follow its offline import flow. Check the actual display to confirm playback. The package contains fixed published content. To distribute changes, prepare a new Ready version, publish it, then export and import an updated package.Step 7: Cancel an export or revoke an offline lease
Withscreens.offline-export, cancel an unwanted export with DELETE /offline-exports/{{export_id}}, your Platform key and a new Idempotency-Key. Cancelling prevents further use of that export; it does not remove a package already imported into a disconnected Player or revoke its issued playback lease.
With screens.read, send GET /screens/{{screen_id}}/offline-leases?limit=25. Save a selected lease’s id as lease_id; use page.nextCursor to read additional pages.
With screens.offline-revoke, send POST /screens/{{screen_id}}/offline-revoke:
Edge LAN or offline package?
- Edge LAN: Screens receive content from an Edge on the local network; see Edge registration and Screen assignment.
- Offline package: a Player imports a downloaded
.lvapkg; export it through the API or the dashboard.

