Retry Change Owner Process Step
Retries a failed step of a paused node ownership change process. The step goes back to pending, its retry_count grows by one and its error is cleared, then the process resumes (in_progress) and sends the step again as a new on-chain transaction. A step can be retried max_retries (3) times. Poll Get Change Owner Process for the outcome. See the overview for the lifecycle.
Only the platform owner's API key may call this endpoint; any other key gets 403.
Required permission: node:change-owner
Request
POST /v2/admin/nodes/{node_id}/change-owner-processes/{process_id}/retry
Parameters
| Name | Type | In | Description |
|---|---|---|---|
node_id | string | path | Required. The node that owns the setup |
process_id | string | path | Required. The process id; must belong to node_id |
Headers
| Name | Description |
|---|---|
Authorization | Required. Bearer <access_token> |
Content-Type | Required. application/json |
Body
| Field | Type | Required | Description |
|---|---|---|---|
step_order | integer | Yes | The order of the failed step (steps start at 1) |
Example
curl --request POST \
--url '{{baseUrl}}/v2/admin/nodes/6901350deb7ed8c1c38de4e9/change-owner-processes/6907a4e1b5c83f2d9e6a0b17/retry' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{
"step_order": 2
}'
Response
204 No Content, no body.
Errors
| Status | Code | Description |
|---|---|---|
| 400 | 10015 | Validation failed: step_order is missing or 0 |
| 400 | 10000 | process_id is not a valid id |
| 400 | 20001 | No process with this id on this node |
| 400 | 20004 | The process has no step with this step_order |
| 400 | 20003 | The step is not failed, or the process is not paused |
| 400 | 20006 | The step already used its max_retries retries |
| 403 | 10005 | The API key does not belong to the platform owner |
| 500 | 10000 | The continuation could not be queued; the process stays paused |
See Errors for the error format and common codes.