---
title: "Update wallet display metadata"
method: PATCH
path: "/api/wallets/by-id/{id}"
tags: ["Wallets", "Wallet and web3"]
---

# Update wallet display metadata

`PATCH /api/wallets/by-id/{id}`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/wallets/by-id/{id}`
- Auth: HTTP bearer

Edit-mode metadata (#888). At least one of `label` (<=40 chars, empty clears), `color` (#RRGGBB, null clears), `icon` (1..64 chars, null clears), `isHidden`. Owner-scoped by wallet id.

## Path parameters

- `id` string, required

## Request body

- object
  - `label` string, nullable: User-set display name; empty string clears
  - `color` string, nullable: User-set accent color
  - `icon` string, nullable: User-set icon key
  - `isHidden` boolean: Soft-hide from the carousel

## Response `200`

{ wallet } — the updated wallet list item

## Other responses

- `400`: VALIDATION_ERROR (empty patch or malformed field)
- `401`: UNAUTHORIZED
- `404`: NOT_FOUND (wallet missing or not owned by the caller)
- `500`: INTERNAL_ERROR (untyped action failure)

## Changes

- **2026-11-18** `3433c08162cf`: 1 breaking
  - added the new path request parameter `id`
- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/wallets/by-id/:id/patch.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
