Restore an earlier version of a Design as a new version
POST/artifacts/:artifactId/versions/:versionId/restore
Stores the source of an earlier version as a NEW version on top of the head: no version is removed. It answers like a push, so a tool handles both alike: 201 with the new version and its build state; 200 when the version asked for is already the head or the restore was already stored; 409 with reason stale_head (and what changed) when the Design moved on since baseVersionId, writer_busy (and retryAfterSeconds) while Copera AI is editing it, or idempotency_key_reused. A changeSummary that looks like a credential is refused with 400 and the field named in issues; invisible characters are removed. Needs edit rights on the Design and a token with the Designs permission.
Request
Responses
- 200
- 201
- 400
- 401
- 403
- 404
- 409
- 429
- 500
- 503
Default Response
Default Response
Default Response
Default Response
Default Response
Default Response
Default Response
Default Response
Default Response
Default Response