Usage by kind and day
Needs the scope account:read
Usage by kind and by day for a period. Everything is counted, whether it was ordered through the API, an agent or your CharpstAR account.
from?stringFirst day, YYYY-MM-DD. Default: the start of the current period.
dateto?stringLast day, YYYY-MM-DD. Default: today.
dateOK
application/json- response
from*stringThe first day counted (UTC).
dateto*stringThe last day counted (UTC), included.
datetotals*array<>Every kind, 0 included.
byDay*array<>Days with usage only, oldest first.
curl -sS "https://platform.charpstar.co/api/v1/usage?from=2026-10-01&to=2026-10-31" \ -H "Authorization: Bearer $CHARPSTAR_API_KEY"{ "from": "2026-10-01", "to": "2026-10-02", "totals": [ { "kind": "model_ordered", "count": 14 }, { "kind": "model_delivered", "count": 9 }, { "kind": "model_replaced", "count": 0 }, { "kind": "packshot", "count": 48 }, { "kind": "scene", "count": 3 }, { "kind": "edit", "count": 0 }, { "kind": "video", "count": 1 }, { "kind": "export", "count": 2 } ], "byDay": [ { "date": "2026-10-01", "kind": "model_ordered", "count": 12 }, { "date": "2026-10-01", "kind": "packshot", "count": 48 }, { "date": "2026-10-01", "kind": "scene", "count": 3 }, { "date": "2026-10-02", "kind": "model_delivered", "count": 9 }, { "date": "2026-10-02", "kind": "model_ordered", "count": 2 }, { "date": "2026-10-02", "kind": "video", "count": 1 }, { "date": "2026-10-02", "kind": "export", "count": 2 } ]}Your plan, areas and usage GET
The account summary an agent reads before it orders: the plan, the areas switched on, what was used in the period and what is left per kind, and this token's own limits.
Create or update products POST
Create or update products by article number: one product, or { products: [...] } with up to 50. - A new article lands in our production team's intake and in your open order. - A known article is updated by the ownership rules. Before modelling starts, every field you own is applied. After that, name, category, links, attributes and active still update, and a change to dimensionsCm or source3dUrl becomes a change request. - A field you leave out keeps its value. - Sending the same product again is safe: it answers unchanged and writes nothing.