Record demand
Tells FurniOps which variants matter now (sold, in carts, on backorder). The sources offering them are checked at their fastest, every 15 minutes, until the demand lapses; stock-only runs where the connector reads stock apart. Variants the organisation cannot see are listed as unknown and ignored. Sources with schedule.adaptive: false keep their intervals.
- Scopes
freshness:write - Rate classwrite
- Idempotency-Key required
/v1/demandTells FurniOps which variants matter now (sold, in carts, on backorder). The sources offering them are checked at their fastest, every 15 minutes, until the demand lapses; stock-only runs where the connector reads stock apart. Variants the organisation cannot see are listed as unknown and ignored. Sources with schedule.adaptive: false keep their intervals.
Authorization
apiKey An API key (fo_live_… / fo_test_…) as a bearer token
In: header
Header Parameters
Dated API version; pinned per organisation on first use and overridable per request
Value in
- "2026-10-01"
- "2026-10-04"
The data the request acts on: test is the organisation's sandbox. An OAuth token picks it (live by default); an API key's mode is fixed, and naming the other one is refused
Value in
- "live"
- "test"
Unique key for this operation, reused on retries (24 h)
1 <= length <= 257Preview the write and change nothing: true answers the would-be response, explain a Preview (application/vnd.furniops.preview+json)
Value in
- "true"
- "explain"
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Variants a tenant wants kept fresh
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/v1/demand" \ -H "Idempotency-Key: string" \ -H "Content-Type: application/json" \ -d '{ "variants": [ "string" ] }'{ "object": "demand", "accepted": 0, "unknown": [ "string" ], "sources": 0, "expires_at": "2019-08-24T14:15:22Z"}Check a variant now POST
Checks the variant's offers now, at a moment that matters such as checkout: each source offering it gets a run (stock only where the connector reads stock apart), joins one under way, or answers with one that finished moments ago (a minute for stock, 15 minutes for a whole catalogue). New values arrive as `offer.changed` events. 404 when the organisation cannot see the variant.
Read the organisation's own catalogue GET
The catalogue the organisation owns in the request's mode, with its product counts. A vendor's catalogue also says where its publication stands and, in `blocked_by`, why publishing would be refused now.