Approve a model or request changes
Needs the scope reviews:write
Approve a model, or send it back to our 3D team with comments. A model that has passed our quality check waits for your approval (review.requested tells you); one that is not waiting for you answers 409 not_ready.
- approve publishes it, exactly as approving in your CharpstAR account does. asset.approved follows once its files are live. A product with variants is approved with all of them.
- request_changes sends it back with your comments. Each comment can carry an image, which we copy to your account.
- From the third change request on the same model, extra revisions will likely be charged. That request is made in your CharpstAR account, where you confirm it; the API answers 409 not_ready.
- A change to a model that is already delivered is requested the same way. It stays delivered and its links keep working while we make the change. Each one counts against your yearly change allowance (402 allowance_reached once it is used up).
article*stringYour article number.
^[A-Za-z0-9][A-Za-z0-9._\-]{0,63}$Idempotency-Key?stringA unique value such as a UUID. A retry with the same key within 24 hours returns the original answer and runs nothing twice; the same key with a different body is refused with 409 idempotency_conflict.
length <= 128application/json- body
decision*stringapprove publishes the model; request_changes sends it back to our 3D team with your comments.
"approve""request_changes"comments?array<>Required with request_changes.
items <= 20OK
application/json- response
articleId*stringdecision*string"approve""request_changes"status*stringWhere the product is. Build your logic on this value.
"received""in_production""in_review""approved""delivered""cancelled"reviewedAt*stringdate-timecurl -sS -X POST https://platform.charpstar.co/api/v1/products/CH-1001/review \ -H "Authorization: Bearer $CHARPSTAR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "decision": "request_changes", "comments": [{ "text": "The seat is too thick", "imageUrl": "https://example.com/seat.jpg" }] }'{ "articleId": "CH-1001", "decision": "approve", "status": "approved", "reviewedAt": "2026-10-21T14:02:00.000Z"}Cancel a product before modelling starts POST
Stop a product before modelling starts. Its status becomes cancelled, it leaves our production queue, and status.changed is sent. A product that has started answers 409 not_cancellable; talk to your CharpstAR contact instead.
How much of your range has 3D GET
How much of your range has a 3D model: counts in total and per category, and the article numbers without one. The question an agent asks before ordering.