Skip to content

Manifest API

The Manifest API is what a device asks, on a schedule you choose, to learn whether it should update. Version 1.8 was released on 12 May 2026 and is backward compatible with every 1.x client.

Base URL and authentication

All endpoints are under https://nl5.enotcloud.com/api/v1/. Device endpoints (check, report) need no secret; they accept the public application identifier and a stable device identifier you generate. Management endpoints need a workspace token in the Authorization: Bearer header.

Check for an update

GET /api/v1/check
  app      required  application id, e.g. acme-notes
  channel  required  stable | beta | nightly | custom name
  version  required  version currently installed
  os       required  windows | macos | linux
  arch     required  x64 | arm64 | universal
  device   required  stable opaque id, 8 to 64 characters
FieldTypeMeaning
updatebooleanTrue when this device should move to a newer version now
versionstringTarget version, only when update is true
deltaobjectPatch from the installed version: from, size, sha256, url. Absent if no valid chain exists
fullobjectFull installer: size, sha256, url. Always present with an update
ringstringThe ring this device was assigned in the current release
expirestimestampSigned metadata is invalid after this time; re-check before using cached values
pollintegerSeconds until the device should ask again; the server raises it under load

Try it

This request returns a sample manifest for a demo application. No account is required.

Response appears here.

Report an install

POST /api/v1/report
{ "app": "acme-notes", "device": "d_test_01",
  "from": "2.7.3", "to": "2.8.0",
  "result": "installed", "method": "delta", "ms": 41230 }

Reports feed the rollout controller. A result of installed counts toward billing; failed, cancelled and rolled_back do not, but failed installs and crashes within the first 10 minutes count against halt thresholds.

Errors

StatusCodeMeaning
400bad_parameterA required query parameter is missing or malformed
404unknown_appApplication id does not exist or has no release on the channel
429rate_limitedRetry after the number of seconds in Retry-After
503region_drainingThe region is being drained for maintenance; retry, the next attempt is routed elsewhere

Honor poll. During launch peaks Verdel raises it for devices in rings that are fully updated, which keeps the check path fast for devices still waiting.