Update Canton Validator

Edit online

Updates an existing Canton Validator configuration.

HTTP request
PUT/networks/{network}/validators/{validatorId}
Authentication
Authentication Type Supported
Organization User (CustomerEmployee) Yes
Delegated User (EndUser) No
Service Account Yes
Required permissions
Networks:CantonValidators:Update (always required)
Authorization requirements
Header Type Required Description
Authorization string Yes Bearer token used to authenticate the request. See Authentication flows for details.
X-DFNS-USERACTION string Yes User Action Signature used to sign change‑inducing requests. See User Action Signing flows for details.
Path parameters
Parameter Type Required Description
network enum string Yes Canton network identifier. Supported values: canton, canton-devnet, canton-testnet.
validatorId string Yes Unique identifier of the validator. Length must be between 1 and 64 characters.
Request body
Field Type Required
name string No
validator object No
ledger object No 
curl --request PUT \
  --url https://api.digitalassets.ibm.com/networks/{network}/validators/{validatorId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DFNS-USERACTION: <api-key>' \
  --data '
{
  "name": "<string>",
  "validator": {
    "url": "<string>",
    "oauth2": {
      "domain": "<string>",
      "audience": "<string>",
      "clientId": "<string>",
      "clientSecret": "<string>",
      "tokenPath": "<string>"
    }
  },
  "ledger": {
    "url": "<string>",
    "oauth2": {
      "domain": "<string>",
      "audience": "<string>",
      "clientId": "<string>",
      "clientSecret": "<string>",
      "tokenPath": "<string>"
    }
  }
}
'
Response
200: Success

Example response:

{
  "id": "cv-7jeof-m584r-p35ucm37ko3cqgts",
  "orgId": "or-30tnh-itmjs-s235s5ontr3r23h2",
  "network": "Canton",
  "kind": "Shared",
  "dateCreated": "<string>",
  "partyHint": "<string>",
  "name": "<string>"
}