Skip to content
LogoLogo

Replace an in-use Project state and archive it

Replace an in-use Project state and archive it

POST/api/v1/project-states/{state_id}/archive-and-replace

Atomically moves active Projects to a different active same-Workspace state and archives the source.

Path Parameters

state_idRequired
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001

Header Parameters

X-CSRF-TokenRequired
string·min 43·max 43

Session-bound CSRF token. It must exactly match the __Host-assign_csrf cookie sent with the request.

Idempotency-KeyRequired
string·min 16·max 200

Opaque client-generated key for safely retrying this operation.

If-MatchRequired
string

Entity tag containing the resource version last observed by the client.

Request Body

application/json
replacement_state_idRequired
string <uuid>

Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.

Example0198ac5e-f9b7-7000-8000-000000000001

Responses

204Projects replaced and source state archived