Cancel Change Owner Process
Cancels a node ownership change process that is not finished (started, in_progress or paused). The process becomes cancelled and no further step is sent. Cancelling does not undo anything already done on-chain: transfers that completed stay with the new wallet, and a step whose transaction was already sent still settles. A new process can be started on the setup afterwards. 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}/cancel
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> |
Example
curl --request POST \
--url '{{baseUrl}}/v2/admin/nodes/6901350deb7ed8c1c38de4e9/change-owner-processes/6907a4e1b5c83f2d9e6a0b17/cancel' \
--header 'Authorization: Bearer <access_token>'
Response
204 No Content, no body. The process status is now cancelled.
Errors
| Status | Code | Description |
|---|---|---|
| 400 | 10000 | process_id is not a valid id |
| 400 | 20001 | No process with this id on this node |
| 400 | 20003 | The process is already completed, failed or cancelled |
| 403 | 10005 | The API key does not belong to the platform owner |
See Errors for the error format and common codes.