Update a wallet

Patches an existing wallet. Supports changing the name, currency, active flag, and the list of products the wallet can be used against.

PATCH /wallets/{id}

Update a wallet

cURL

curl --request PATCH \
  --url https://api.alguna.io/wallets/{id} \
  --header 'Alguna-Version: <alguna-version>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "active": true,
  "currency": "<string>",
  "name": "<string>",
  "product_ids": [
    "<string>"
  ]
}
'

200

{
  "active": true,
  "created_at": "2026-04-01T10:00:00Z",
  "currency": "USD",
  "current_balance": "<string>",
  "customer_id": "cust_01H2ABC",
  "id": "wlt_01H1VECT",
  "name": "Main Wallet",
  "updated_at": "2026-04-01T12:30:00Z",
  "product_ids": [
    "<string>"
  ]
}

Authorizations

Authorization · string · header · required

API key authentication. Pass your API key as a Bearer token.

Headers

Alguna-Version · enum<string> · required

Available options: 2026-04-01

Idempotency-Key · string

A unique string that makes a retried write safe. If you send the same request with the same key within 24 hours, the API returns the stored response and does not run the request again. A 5xx or 429 response is not stored, so a retry with that key runs the request again.

Maximum string length: 255

Example:

"ik_a1b2c3d4e5f6"

Path Parameters

id · string · required

Unique identifier for the wallet

Body

application/json

active · boolean | null

Whether the wallet is active

currency · string | null

Currency code

name · string | null

Name of the wallet

product_ids · string[] | null

Product IDs that can be purchased with this wallet

Response

200

application/json

Success

active · boolean · required

Whether the wallet is active

Example:

true

created_at · string<date-time> · required

Timestamp when the wallet was created

Example:

"2026-04-01T10:00:00Z"

currency · string · required

Currency code

Example:

"USD"

current_balance · string · required

Current balance of the wallet

customer_id · string · required

Identifier of the customer that owns this wallet

Example:

"cust_01H2ABC"

id · string · required

Unique identifier for the wallet

Example:

"wlt_01H1VECT"

name · string · required

Name of the wallet

Example:

"Main Wallet"

updated_at · string<date-time> · required

Timestamp when the wallet was last updated

Example:

"2026-04-01T12:30:00Z"

product_ids · string[]

Product IDs that can be purchased with this wallet