TIPTIP
API Reference

Update wallet

POST
/v1/identity/{tag}/wallet

Builds an UNSIGNED update_wallet transaction for the caller to sign and submit themselves; the server never signs it. The mirror's wallet column does not change from this call, it changes only once the indexer observes the update_wallet instruction land on-chain. Changing the wallet never changes the tag's owner. TagOwnershipGuard validates the tag format before the handler runs (400 on malformed input) and then checks existence and ownership (404 for a missing or blocked tag, 403 for a real tag owned by someone else).

AuthorizationBearer <token>

In: header

Path Parameters

tag*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/identity/string/wallet" \  -H "Content-Type: application/json" \  -d '{    "wallet": "8L2Z3nSXbwoFhK9x9BEs6b1qhF6xEcNJ7T4NqmiWaeuf"  }'
{  "transaction": "AQABAwLd0EBAvJf3fKh1QMwbTvbnFbf/lYw/BhqlBTQU2WeUsWfz9L5o1LYh...",  "pda": "3fMxKPQvRnZ8Ldq2vBcTHYRWQnJ8gAxE4tCyF6mWzUKp",  "lastValidBlockHeight": "301234567"}