Read many articles, or what changed
Needs the scope assets:read
Pass articles (up to 100, comma separated) to read several at once, or since to get every article that changed after that time, oldest change first, 100 a page. With since, keep calling with cursor set to nextCursor until it is null. A product can appear in two runs in a row; write its current state, keyed on articleId.
articles?stringUp to 100 article numbers, comma separated.
since?stringAn ISO 8601 time with a zone. Every article that changed after it.
date-timecursor?stringWith since: the nextCursor of the previous page.
OK
application/json- response
client*The company the key belongs to.
assets*array<>unknown*array<string>Article numbers you asked for that we do not have.
nextCursor*|Pass it as cursor for the next page. null when there is no more.
curl -sS "https://platform.charpstar.co/api/v1/assets?articles=CH-1001,CH-1002" \ -H "Authorization: Bearer $CHARPSTAR_API_KEY"curl -sS "https://platform.charpstar.co/api/v1/assets?since=2026-10-20T00:00:00Z" \ -H "Authorization: Bearer $CHARPSTAR_API_KEY"{ "client": { "id": "e2b7c1d4-5a6f-4b8c-9d0e-1f2a3b4c5d6e", "name": "Your Company" }, "assets": [ { "articleId": "CH-1001", "name": "Oslo lounge chair", "status": "delivered", "deliveryDate": "2026-10-20", "updatedAt": "2026-10-20T09:30:00.000Z", "glbUrl": "https://cdn.charpstar.net/YourCompany/Android/CH-1001.glb", "usdzUrl": "https://cdn.charpstar.net/YourCompany/iOS/CH-1001.usdz", "usdzReady": true, "thumbnailUrl": "https://cdn.charpstar.net/YourCompany/Thumbnails/CH-1001.png", "viewerUrl": "https://platform.charpstar.co/agent-viewer?glb=https%3A%2F%2Fcdn.charpstar.net%2FYourCompany%2FAndroid%2FCH-1001.glb&name=Oslo%20lounge%20chair&viewer=default", "arUrl": "https://platform.charpstar.co/ar/0b6c9f0e-5d1a-4c47-9f4e-2a1d3c4b5e6f", "embed": { "dataClient": "YourCompany", "dataArticleId": "CH-1001", "snippet": "<script src=\"https://js.charpstar.net/V2/charpstAR-Base.js\" data-client=\"YourCompany\" data-language=\"en-gb\" defer></script>\n<charpstar-viewer data-articleid=\"CH-1001\"></charpstar-viewer>" }, "images": [ { "id": "8d2f4c1a-packshot", "type": "packshot", "variant": "Oak", "url": "https://cdn.charpstar.net/YourCompany/Packshots/CH-1001-front.png", "fileName": "CH-1001_packshot_front_1.png", "width": 2048, "height": 2048, "bytes": 412331, "createdAt": "2026-10-20T09:00:00.000Z", "approved": true, "primary": true, "jobId": null }, { "id": "thumbnail:0b6c9f0e-5d1a-4c47-9f4e-2a1d3c4b5e6f", "type": "thumbnail", "variant": null, "url": "https://cdn.charpstar.net/YourCompany/Thumbnails/CH-1001.png", "fileName": "CH-1001_thumbnail_1.png", "width": null, "height": null, "bytes": 88120, "createdAt": "2026-10-20T08:55:00.000Z", "approved": true, "primary": false, "jobId": null } ], "variations": [ { "articleId": "CH-1001-B", "status": "in_production", "thumbnailUrl": null, "glbUrl": null } ] } ], "unknown": [ "CH-1003" ], "nextCursor": null}The result
An answer for a delivered article carries viewerUrl. This is that address for an article of our Demo company.
Read one article GET
Everything we deliver for one article: its status, the 3D files, the viewer and AR links, the embed snippet, images and variants. Links are null until the product is delivered. glbUrl and usdzUrl never change for an article; when a model is updated the file behind them changes, and the CDN serves ETag and Last-Modified so you can tell.
Start one job or a batch POST
Start one job, or up to 50 as { jobs: [...] }. Jobs run our production services on a delivered product: packshot renders, AI scenes, image edits, videos and 3D exports. Every job type runs. - Jobs queue, and the results are added to the product: new images appear in images[] with the job's id, asset.images.updated is sent, and job.succeeded carries the job with its outputs. - Pictures are made in the order asked, and each is saved under its fileName from the start. - A batch answers a results array like POST /api/v1/products. - A product without a delivered model answers 409 not_ready (edit jobs work on an image and need no model). - AI jobs (scenes, edits, scene videos) run for an account with an allowance of their kind; without one they answer 403 forbidden. - An export to a format not switched on for your account answers 403 forbidden.