---
title: "Update a wallet"
method: PATCH
path: "/v2/wallets"
tags: ["wallet"]
---

# Update a wallet

`PATCH /v2/wallets`

This endpoint updates a wallet within a specified namespace and teamId. This endpoint allows you to modify attributes such as the wallet's name, credit limit, daily budget, external ID, and other relevant fields.

## Request body

- V2UpdateWalletRequest
  - `wallet` Billingv2UpdateWallet, required
    - `id` string, required — The wallet identifier.
    - `namespaceId` string — The namespace identifier that associates the wallet with a team.
    - `teamId` string — The unique team identifier assigned for the wallet.
    - `name` string — The wallet name.
    - `externalId` string — The optional external ID field for storing custom identifiers such as Placement IO numbers, purchase order numbers, or Salesforce numbers for tracking purposes. Partners can use this field to associate external identifiers with the wallet. Must be shorter than 255 characters.
    - `currencyCode` string — The wallet currency code using the 3-letter ISO 4217 standard.
    - `creditLimit` string — The maximum credit limit for the wallet.
    - `dailyBudget` string — The daily spending limit for the wallet.
    - `archived` boolean — Whether the wallet is archived.

## Response `200`

Details of the updated wallet.

- V2UpdateWalletResponse
  - `wallet` Billingv2UpdateWalletRes
    - `id` string — The wallet identifier.
    - `namespaceId` string — The namespace identifier that associates the wallet with a team.
    - `teamId` string — The unique team identifier assigned for the wallet.
    - `name` string — The wallet name.
    - `externalId` string — The optional external ID field for storing custom identifiers such as Placement IO numbers, purchase order numbers, or Salesforce numbers for tracking purposes. Partners can use this field to associate external identifiers with the wallet. Must be shorter than 255 characters.
    - `currencyCode` string — The wallet currency code using the 3-letter ISO 4217 standard.
    - `creditLimit` string — The maximum credit limit for the wallet.
    - `dailyBudget` string — The daily spending limit for the wallet.
    - `archived` boolean — Whether the wallet is archived.

## Other responses

- `400` — There was a problem with input.
- `401` — Login failed or token not valid.
- `403` — Access denied due to insufficient permissions.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/citrusad/apis/citrus-auth-api.md) · [All operations](https://skmtc.net/citrusad/apis/citrus-auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/citrusad/citrus-auth-api/versions/a040003c7378/schema)