Sign in
End User Accounts

Revoke account-scoped delegation for end user

Changed on

Revokes the active account-scoped delegation for the specified end user account. Other account-scoped delegations for the same user are unaffected. This operation can be performed by the end user themselves or by a developer using their API key. When the address corresponds to an EVM Smart Account, this revokes the delegation for the Smart Account's owner EOA.

post/v2/embedded-wallet-api/end-users/{userId}/address/{address}/delegation/revoke

Request

  • Base URL: https://api.cdp.coinbase.com/platform
  • URL: https://api.cdp.coinbase.com/platform/v2/embedded-wallet-api/end-users/{userId}/address/{address}/delegation/revoke
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

userIdstring required
Example:e051beeb-7163-4527-a5b6-35e301529ff2

The ID of the end user.

addressstring required

A blockchain address. Format varies by network (e.g., 0x-prefixed for EVM, base58 for Solana).

Example:0x742d35Cc6634C0532925a3b844Bc454e4438f44e

The blockchain address of the end user account whose delegation should be revoked. For EVM addresses, matching is case-insensitive.

Query parameters

projectIDstring
Example:8e03978e-40d5-43e8-bc93-6894a57f9324

The ID of the CDP Project. Required for end users authenticated using custom auth (i.e. a non-CDP JWT provider).

Headers

X-Wallet-Authstring

A JWT signed using your Wallet Secret, encoded in base64. Refer to the Generate Wallet Token section of our Authentication docs for more details on how to generate your Wallet Token.

X-Developer-Authstring

A JWT signed using your Wallet Secret, encoded in base64. Refer to the Generate Wallet Token section of our Authentication docs for more details on how to generate your Wallet Token.

X-Idempotency-Keystring

An optional string request header for making requests safely retryable. When included, duplicate requests with the same key will return identical responses. Refer to our Idempotency docs for more information on using idempotency keys.

Request body

walletSecretIdstring

When revoking with a wallet authentication scheme, the ID of the Temporary Wallet Secret that was used to sign the X-Wallet-Auth Header.

Example request

{
  "walletSecretId": "e051beeb-7163-4527-a5b6-35e301529ff2"
}

Response

Delegation revoked successfully.

Changes