Skip to content
LogoLogo

Apply a previewed status mapping as a durable migration job

Apply a previewed status mapping as a durable migration job

POST/api/v1/workspaces/{workspace_id}/lifecycle-definitions/{definition_id}/mapping-applications

Requires Workspace management authority and an Idempotency-Key; a repeat with the same key and mapping returns the original job and a different mapping is 409 idempotency_key_conflict. The request is re-validated against If-Match and destination_revisions (409 lifecycle_preview_stale or revision_conflict), and material behavior changes or a default replacement need acknowledged: true (409 lifecycle_acknowledgement_required). Scopes within the 1,000-entity synchronous limit are moved before the response (200, status completed, or 202 when a retry is pending); larger scopes return 202 and a background worker moves bounded pages. A Workspace has one applying job (409 lifecycle_migration_pending).

Path Parameters

workspace_idRequired
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001
definition_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
mappingsRequired
object

Source status ID to destination status ID. A source mapped to itself keeps its ID and entities. Sources are exactly the keys.

destination_revisions
object

Apply only. The destination_revisions returned by the preview.

acknowledged
boolean

Apply only. Required when the preview reports requires_acknowledgement.

Responses