Displays On Demand
Self-service asset library for creating and measuring individual Displays faces on a pay-as-you-go credit basis, with a synchronous draft to final measurement lifecycle.
Displays On Demand is the self-service mode of the Displays family. Instead of subscribing to a monthly inventory feed, you create individual face assets through the API and purchase measurements on a per-asset, pay-as-you-go basis. Each asset moves through a lifecycle from draft to a final, published measurement.
The asset library is exposed through REST endpoints on the Motionworks API v2 base (https://api2.mworks.com) under the /v2/displays/* path. The full endpoint-by-endpoint reference is auto-built from the OpenAPI spec at Displays API reference.
Lifecycle at a glance
Every asset progresses through a three-state lifecycle:
draft -> draft_measured -> final_measured- draft: the asset exists with its geometry and display attributes but has no measured results. You can refine the anchor, classification, and display attributes freely.
- draft_measured: a draft measurement has completed. The asset carries draft-level OTS/LTS results but is not yet published as a final, viewable inventory record.
- final_measured: the asset has a final measurement and is published. A
display_id(the Motionworks-issued display identifier) is minted at this stage, making the asset joinable to the broader Displays inventory surface.
See Asset lifecycle for the create, list, refine, and archive recipes.
How On Demand differs from Viewcast Profiles
| Dimension | Viewcast Profiles | Displays On Demand |
|---|---|---|
| Access model | Subscription to monthly inventory feed | Self-service per-asset creation and purchase |
| Inventory | Every face in the customer portfolio, published monthly | Individual faces you define and measure on demand |
| Delivery | Snowflake secure view (table exports) | REST API (synchronous create, poll, read) |
| Pricing | Subscription tier | Credit-metered per operation (see Purchase flow) |
| Identifiers | viewshed_id (Motionworks-issued) on every record | asset_id (Supabase-issued String) on creation; display_id minted only at final_measured |
Profiles gives you a broad, pre-published inventory snapshot delivered on a monthly cadence. On Demand lets you measure a specific face that may not yet exist in the Profiles catalog, on your own schedule, paying per measurement.
Endpoint map
All endpoints are on the v2 base https://api2.mworks.com. The base per-endpoint cost is 1 credit (displays_asset_crud). Measurement purchases carry additional credits (see Purchase flow).
| Method | Path | Purpose | Base cost |
|---|---|---|---|
| POST | /v2/displays/assets | Create a new asset (synchronous, 200) | 1 cr + purchase |
| GET | /v2/displays/assets | List and filter assets | 1 cr |
| GET | /v2/displays/assets/summary | Summary counts by state | 1 cr |
| GET | /v2/displays/assets/{asset_id} | Read a single asset | 1 cr |
| PATCH | /v2/displays/assets/{asset_id} | Refine anchor or display attrs | 1 cr |
| DELETE | /v2/displays/assets/{asset_id} | Archive an asset | 1 cr |
| POST | /v2/displays/assets/{asset_id}/measurements | Queue a draft or final measurement | 1 cr + purchase |
| GET | /v2/displays/assets/{asset_id}/measurements/latest | Poll the latest measurement | 1 cr |
| GET | /v2/displays/profiles/{viewshed_id} | Read a published display profile | 1 cr (owned) or 300 cr (unowned direct-add) |
| POST | /v2/displays/search | Search display assets by filters | 1 cr |
For the full request and response schemas, parameter names, and error codes, see the auto-built Displays API reference.
Feature entitlements
On Demand requires feature keys on your organization:
oohdisplays.displays.library- CRUD access to the asset library (create, list, read, refine, archive).oohdisplays.displays.measurements- queue and poll measurements, and access display profiles.
Organizations on a pay-as-you-go billing rail with these features enabled can create and measure assets immediately.
What to read next
- Asset lifecycle - create, list, refine, archive recipes with identifier semantics.
- Purchase flow and credits - the credit model, idempotency, refunds, and subscription window.
- Measurements - queue, poll, the 202 contract, SLA posture, and publication batch.
- Methodology delta - what is shared with Profiles and what differs.
- Displays Search - search display assets by a closed filter set.
- Viewcast Methodology - the full geometric and traffic model.
- Displays API reference - auto-built endpoint documentation.
Updated about 1 hour ago