---
title: "Set a wallet's display label"
method: POST
path: "/wallets/v1/{address}/label"
tags: ["Billing"]
---

# Set a wallet's display label

`POST /wallets/v1/{address}/label`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/wallets/v1/{address}/label`
- Auth: API key in header `SIGN-IN-WITH-X`

Set (or clear) a wallet's server-side display label. SIWX-authenticated; the signer MUST equal the {address} being labeled (proof of control) or the call returns 403 WALLET_SIGNER_MISMATCH. Body { label }: letters, digits, space, '.', '_' or '-' (max 64); null or empty clears it. Non-unique by design — display metadata only, the address remains the identity.

## Path parameters

- `address` string, required

## Request body

- object
  - `label` string, nullable, required: Display name; null or empty string clears it.

## Response `200`

Label stored

- object
  - `address` string, required
  - `label` string, nullable, required

---

[API](https://skmtc.dev/run402/apis/run402-api.md) · [All operations](https://skmtc.dev/run402/apis/run402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/run402/apis/run402-api/revisions/893607557f50?raw)