Retry one blocked release migration target.

POST

/api/admin/platform/control-plane/release-rollout/{operationId}/targets/{targetId}/retry

Code sample: Shell / cURL

curl --request POST \
  --url https://auth.example.com/api/admin/platform/control-plane/release-rollout/example/targets/example/retry \
  --header 'Authorization: Bearer <token>' \
  --header 'Idempotency-Key: example'

Opens a new bounded retry window for one blocked database target. This recovery action is environment-scoped, idempotent, restricted to a human platform administrator, and remains available while normal Admin mutations are fenced.

Authorizations

• adminBearer
• adminSessionCookie

Parameters

Path Parameters

operationId

required

string

>= 1 characters <= 256 characters /^[a-zA-Z0-9][a-zA-Z0-9._:-]*$/

targetId

required

string

>= 1 characters <= 256 characters /^[a-zA-Z0-9][a-zA-Z0-9._:-]*$/

Header Parameters

Idempotency-Key

required

string

>= 1 characters <= 256 characters /^[a-zA-Z0-9][a-zA-Z0-9._:-]*$/

Responses

202

Target retry accepted.

Media type application/json

object

rollout

required

object

operationId

required

string | null

sourceVersion

required

string | null

targetVersion

required

string | null

phase

required

string

Allowed values: idle database_rollout blocked awaiting_setup verifying completed

completedTargets

required

integer

totalTargets

required

integer

adminMutationMode

required

string

Allowed values: available read_only

lastErrorCode

required

string | null

updatedAt

required

integer | null

>= 1

blockedTargetCount

required

integer

blockedTargets

required

Array<object>

<= 100 items

object

targetId

required

string

streamId

required

string

Allowed values: core-d1 pii-d1 lookup-d1

attemptCount

required

integer

lastErrorCode

required

string

updatedAt

required

integer

>= 1

key

additional properties

key

additional properties

auditId

required

string

key

additional properties

Example

{
  "rollout": {
    "phase": "idle",
    "adminMutationMode": "available",
    "blockedTargets": [
      {
        "streamId": "core-d1"
      }
    ]
  }
}

400

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

401

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

403

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

409

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

503

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}