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
| Field | Type | Meaning |
|---|---|---|
update | boolean | True when this device should move to a newer version now |
version | string | Target version, only when update is true |
delta | object | Patch from the installed version: from, size, sha256, url. Absent if no valid chain exists |
full | object | Full installer: size, sha256, url. Always present with an update |
ring | string | The ring this device was assigned in the current release |
expires | timestamp | Signed metadata is invalid after this time; re-check before using cached values |
poll | integer | Seconds 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
| Status | Code | Meaning |
|---|---|---|
| 400 | bad_parameter | A required query parameter is missing or malformed |
| 404 | unknown_app | Application id does not exist or has no release on the channel |
| 429 | rate_limited | Retry after the number of seconds in Retry-After |
| 503 | region_draining | The 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.