List model file revisions
GET/api/v1/models/{model_id}/revisions
Overview
Owner-only immutable source history, newest revision first. Use limit (1–100, default 20) and cursor. Returns data, has_more and next_cursor. Names and sizes remain current model settings. Missing or deleted models return 404 model_not_found.
Requires models:read.
Parameters
model_id path · required
Immutable model ID: MD- followed by eight uppercase Crockford Base32 characters. Use this same ID in the website, URLs and API; pass it unchanged.
string
limit query · optional
Maximum number of results.
integer
cursor query · optional
Opaque next_cursor from the previous page. Keep the same account, resource, filters and limit.
string
Responses
Revision page.
200 response
JSON
{
"data": [
{
"number": 2,
"label": "2",
"source": {
"file_id": "file_7c82bd3e319b4bb099310d54a761879e"
},
"filename": "figurine-v2.zip",
"created_at": "2026-09-30T00:01:00.000000Z",
"current": false,
"repairs": [
{
"repair": 1,
"label": "2.1",
"source": {
"file_id": "file_8c82bd3e319b4bb099310d54a761879e"
},
"filename": "figurine-v2-repaired.zip",
"created_at": "2026-10-03T09:00:00.000000Z",
"current": true
}
]
},
{
"number": 1,
"label": "1",
"source": {
"file_id": "file_6c82bd3e319b4bb099310d54a761879e"
},
"filename": "figurine.zip",
"created_at": "2026-09-18T18:00:00.000000Z",
"current": false,
"repairs": []
}
],
"has_more": false,
"next_cursor": null
}data array · required
data item fields
number integer · required
Minimum: 1
source object · required
Reference to an uploaded geometry file and its supporting assets. One file can back multiple models in the same account. Set print size explicitly using longest_dimension_mm.
source fields
file_id string · required
Unique, server-generated file ID. Treat it as an opaque reference.
Min length: 37 · Max length: 37
filename string · required
created_at string (date-time) · required
current boolean · required
label string · required
repairs array · required
Published model repairs of this upload, newest first (1.1 repairs 1).
repairs item fields
repair integer · required
Minimum: 1
label string · required
source object · required
Reference to an uploaded geometry file and its supporting assets. One file can back multiple models in the same account. Set print size explicitly using longest_dimension_mm.
source fields
file_id string · required
Unique, server-generated file ID. Treat it as an opaque reference.
Min length: 37 · Max length: 37
filename string · required
created_at string (date-time) · required
current boolean · required
has_more boolean · required
next_cursor string | null · required
Opaque signed cursor; null on the last page.
Response headers
X-Request-IDRequest identifier for support. Send X-Request-ID with 8–64 ASCII letters, digits or hyphens to reuse that value; otherwise the server generates a UUID4 hex value. Include the returned X-Request-ID in support requests. Do not put secrets or account IDs in this value.
Errors
| HTTP | Code | What to do |
|---|---|---|
| 400 Bad Request | invalid_argument | A field, query parameter or header is invalid. Fix the field named in details, then send the request again. |
| 401 Unauthorized | unauthenticated | The API key is missing, invalid or revoked. Send a valid business API key in Authorization: Bearer. |
| 403 Forbidden | permission_denied | The key lacks the endpoint's scope, or payments lack spending consent. Check the scope listed on the endpoint. |
| 404 Not Found | model_not_found | No model with this ID exists in the account, or it was deleted. Check the ID. |
| 429 Too Many Requests | resource_exhausted | A rate or account limit was reached. Wait at least Retry-After seconds, then retry. |
| 500 Internal Server Error | internal | The server failed unexpectedly. Retry with backoff; contact support with X-Request-ID if it persists. |
| 503 Service Unavailable | unavailable | A required service is briefly unavailable. Retry with backoff, reusing the same Idempotency-Key. |
API v1 preview