Skip to main content
POST
Emit cutover swap operator commands

Authorizations

Authorization
string
header
required

API key issued per entity via Settings > Developers > API Keys. Each key carries scopes (e.g. orders:read, products:write). Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.

Path Parameters

entity_id
string<uuid>
required

Body

application/json
snapshot_id
string
required

The snapshot_id from POST .../snapshot.

freeze_token
string<uuid>
required

The freeze_token confirming the entity is still frozen.

lambda_alias_target_version

Optional specific Lambda version number to target in rollback command.

Response

Swap command list emitted

Operator command list returned by cutover/swap endpoint.

object
enum<string>
Available options:
cutover_swap_initiated
entity_id
string<uuid>
swap_emitted_at
string<date-time>
cutover_log_id
string<uuid>
snapshot_id
string
env
string
instructions
object

Operator commands to paste (do NOT auto-execute).