---
title: "Update wallets in bulk"
method: PATCH
path: "/v2/wallets/bulk/update"
tags: ["BulkWalletOperations"]
---

# Update wallets in bulk

`PATCH /v2/wallets/bulk/update`

This endpoint updates multiple wallets simultaneously. Use this endpoint to update name, external ID, archived status, daily budget, and credit limit.

## Request body

- V2BulkUpdateWalletRequest
  - `wallets` Billingv2UpdateWallet[], required — The bulk update request containing wallet identifiers and fields to modify.
    - `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 wallets.

- V2BulkUpdateWalletResponse
  - `bulkId` string — Unique identifier for the bulk operation.
  - `status` 'BULK_OPERATION_SUBMITTED' | 'BULK_OPERATION_IN_PROGRESS' | 'BULK_OPERATION_COMPLETED' | 'BULK_OPERATION_FAILED'
  - `message` string — Success message for the operation.

## 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/revisions/a040003c7378/schema)