Delete Canton Validator

Deletes a specific Canton Validator configuration from your organization.

HTTP request

DELETE/networks/{network}/validators/{validatorId}

Authentication

Authentication Type	Supported
Organization User (CustomerEmployee)	Yes
Delegated User (EndUser)	No
Service Account	Yes

Required permissions

Networks:CantonValidators:Delete (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 to delete. Length must be 1 to 64 characters.

Request body

curl --request DELETE \
  --url https://api.digitalassets.ibm.com/networks/{network}/validators/{validatorId} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-DFNS-USERACTION: <api-key>'

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>"
}