Viewcast On Demand
Self-service asset library for creating and measuring individual Viewcast faces on a pay-as-you-go credit basis, with an async draft to final measurement lifecycle.
Viewcast On Demand is the self-service mode of the Viewcast 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 an async lifecycle from draft to a final, published measurement.
The asset library is exposed through nine REST endpoints on the Motionworks API v2 base (https://api2.mworks.com). The full endpoint-by-endpoint reference is auto-built from the OpenAPI spec at Viewcast 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
viewshed_id(the Motionworks-issued viewshed identifier) is minted at this stage, making the asset joinable to the broader Viewcast inventory surface.
See Asset lifecycle for the create, list, refine, and archive recipes.
How On Demand differs from Viewcast Profiles
| Dimension | Viewcast Profiles | Viewcast 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 (async 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; viewshed_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 (viewcast_asset_crud). Measurement purchases carry additional credits (see Purchase flow).
| Method | Path | Purpose | Base cost |
|---|---|---|---|
| POST | /v2/viewcast/assets | Create a new asset (async, 202) | 1 cr + purchase |
| GET | /v2/viewcast/assets | List and filter assets | 1 cr |
| GET | /v2/viewcast/assets/summary | Summary counts by state | 1 cr |
| GET | /v2/viewcast/assets/{asset_id} | Read a single asset | 1 cr |
| PATCH | /v2/viewcast/assets/{asset_id} | Refine anchor or display attrs | 1 cr |
| DELETE | /v2/viewcast/assets/{asset_id} | Archive an asset | 1 cr |
| POST | /v2/viewcast/assets/{asset_id}/measurements | Queue a draft or final measurement | 1 cr + purchase |
| GET | /v2/viewcast/assets/{asset_id}/measurements/latest | Poll the latest measurement | 1 cr |
| GET | /v2/viewcast/profiles/{viewshed_id} | Read a published viewshed profile | 1 cr (owned) or 300 cr (unowned direct-add) |
For the full request and response schemas, parameter names, and error codes, see the auto-built Viewcast API reference.
Feature entitlements
On Demand requires two feature keys on your organization:
viewcast.assets.library- CRUD access to the asset library (create, list, read, refine, archive).viewcast.assets.measurements- queue and poll measurements, and access viewshed profiles.
Both keys are part of catalog_version 2. 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.
- Viewcast Methodology - the full geometric and traffic model.
- Viewcast API reference - auto-built endpoint documentation.
Updated about 3 hours ago