Skip to main content
PUT
/
platform
/
admin
/
custodians
/
{id}
/
contract_ownership
Update contract ownership permission
curl --request PUT \
  --url https://api.example.com/platform/admin/custodians/{id}/contract_ownership
{
  "isSuccess": true,
  "isFailure": false,
  "error": null,
  "value": {
    "id": 42,
    "name": "Example"
  }
}

​
Description

Modifies the contract ownership permission for a custodian. When enabled, the custodian’s wallets can deploy, own, and manage smart contracts on supported blockchain networks.

​
Input

  • id (long, required) — The unique identifier of the custodian.
  • value (bool, required) — New permission value (true = allowed, false = not allowed).

​
Output

Returns a response object containing:
  • success (bool) — Whether the update was successful.
  • message (string) — Confirmation message.

​
Examples

Request 
PUT /api/platform/custodians/42/contract-ownership?value=true
Response (200 OK) 
{
  "data": {
    "success": true,
    "message": "Contract ownership permission updated successfully"
  },
  "isSuccess": true
}

​
Errors

  • 400 Bad Request: Invalid custodian ID or permission value.
  • 401 Unauthorized: Authentication required but not provided.
  • 403 Forbidden: Caller does not have permission to update custodians.
  • 404 Not Found: Custodian with specified ID does not exist.
  • 500 Internal Server Error: Unexpected error occurred during update.

​
Notes

Contract ownership permission should only be enabled for custodians that need to deploy or manage smart contracts. This is typically used for token deployment, governance contracts, or other DeFi operations.

Path Parameters

​
id
integer<int64>
required

The unique identifier of the custodian to update.

Query Parameters

​
value
boolean

The new contract ownership permission (true for allowed, false for not allowed).

​
api-version
string | null

Response

Contract ownership permission updated successfully.

Wrapper for API operation results containing success status, error information, and return value.

​
isSuccess
boolean

True if the operation completed successfully, false otherwise.

Example:

true

​
isFailure
boolean

True if the operation failed, false otherwise.

Example:

false

​
error
object

Error information returned when the operation fails.

Example:
{
  "code": "ValidationError",
  "message": "The request parameters failed validation.",
  "info": [
    "The Name field is required.",
    "The Id field must be greater than 0."
  ]
}
​
value
object

The result value returned when the operation is successful.

Example:
{ "success": true }