---
title: "Update a wallet share"
method: POST
path: "/api/v2/{coin}/walletshare/{shareId}"
tags: ["Wallet share"]
---

# Update a wallet share

`POST /api/v2/{coin}/walletshare/{shareId}`

## Path parameters

- `coin` string, required — A cryptocurrency or token ticker symbol.
- `shareId` string, required

## Request body

- object
  - `state` 'pendingapproval' | 'active' | 'accepted' | 'canceled' | 'rejected', required
  - `encryptedPrv` string — Private key encrypted by the accepting user, used when accepting a wallet share to add to the user's keychains for using the wallet. Required when accepting a share that includes a keychain or when userMultiKeyRotationRequired is true.
  - `pub` string — Public key of the accepting user. Required for multi-user-key wallet shares (when userMultiKeyRotationRequired is true). Optional for non-multi-user-key wallets. If provided for non-multi-user-key wallets, it will be validated against the wallet's user key public key.
  - `keyId` string — Key ID for key rotation verification (deprecated).
  - `signature` string — Signature for key rotation verification (deprecated).
  - `payload` string — Payload for key rotation verification (deprecated).
  - `webauthnInfo` object — Passkey PRF wallet encryption data. When provided alongside encryptedPrv on a hot wallet, attaches the passkey device metadata to the user key.
    - `prfSalt` string, required — PRF salt used for key derivation.
    - `otpDeviceId` string, required — The passkey OTP device ID.
    - `encryptedPrv` string, required — Private key encrypted with the PRF-derived key.

## Response `200`

OK

- PlatformUpdateWalletShareResponse
  - `state` 'pendingapproval' | 'active' | 'accepted' | 'canceled' | 'rejected'
  - `changed` boolean

---

[API](https://skmtc.net/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.net/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitgo/bitgo-api/revisions/e445c15e5bee/schema)