Initiate wallet reshare

This operation initiates a key reshare for the specified wallet. Only the wallet owner may call this endpoint (for example, after completing wallet pairing).

The operation creates a WaaS Signing key share holder group for the provided TSS node_id, binds that node to the owner principal, then submits a KeyGenFromKeyGroup TSS request to derive a new signing group from the vault’s existing main group.

Optional: token — when set, the backend resolves the matching claim row’s purpose (pair requires the row to be paired; restore requires a confirmed (paired) restore code minted after the first pair flow, and it must be used before expiry).

Reshare is asynchronous. Poll the wallet TSS callback endpoint or the WaaS TSS request status to track completion.

POST /api/v1/wallets/{wallet_uuid}/reshare

Initiate wallet reshare

Python

import requests

url = "https://api.example.com/api/v1/wallets/{wallet_uuid}/reshare"

payload = {
    "node_id": "<string>",
    "token": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

200

{
  "result": {
    "tss_request_id": "<string>"
  },
  "success": true,
  "suggestion": "",
  "message": "",
  "meta": {
    "total": 123,
    "offset": 123,
    "limit": 123,
    "has_more": true,
    "after": "<string>",
    "before": "<string>"
  }
}

Headers

X-API-Key · string | null

Path Parameters

wallet_uuid · string<uuid> · required

Body

application/json

Owner's TSS node for creating a Signing group, then KeyGenFromKeyGroup TSS from main group.

node_id · string · required

The human principal's TSS node id (bound to the wallet owner).

Minimum string length: 1

token · string | null

Optional 8-digit code. The backend resolves the token's purpose (pair vs restore) from the matching claim row: pair requires a post-confirm (paired) claim row; restore requires a confirmed (paired) restore code and must be used before it expires. Omit in older app versions.

Required string length: 8

Pattern: ^\d{8}$

Response

200

application/json

Successful Response

result · WalletReshareResponse · object · required

WaaS TSS request id for the reshare operation.

Show child attributes

success · boolean · default: true

suggestion · string · default: ""

message · string · default: ""

meta · PaginationMeta · object

Pagination metadata for list responses.

Supports both legacy offset-based and cursor-based pagination. Cursor fields (has_more, after, before) are populated for cursor-paginated endpoints. Legacy fields (offset, limit) are populated when the caller uses the deprecated offset parameter.

Show child attributes