> ## Documentation Index
> Fetch the complete documentation index at: https://avenue.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Wallet

> Update the metadata or system prompt for an existing wallet.

## Request Headers

<ParamField header="x-api-key" type="string" required>
  Your live or test API key.
</ParamField>

## Path Parameters

<ParamField path="wallet_id" type="string" required>
  The Avenue wallet ID.
</ParamField>

## Request Body

<ParamField body="label" type="string">
  The new human-readable label.
</ParamField>

<ParamField body="system_prompt" type="string">
  The updated AI instructions.
</ParamField>

## Response

<Note>
  All amounts and balances in this endpoint are represented in **kobo** (e.g., `500000` = ₦5,000.00). Ensure you do not send or expect Naira values.
</Note>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "id": "e4b3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
      "customer_reference": "user_987",
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.doe@example.com",
      "label": "John Doe — School Fees",
      "account_number": "2211334455",
      "bank_name": "Nomba MFB",
      "account_name": "PropTech Inc / John Doe",
      "balance": 1500000,
      "currency": "NGN",
      "status": "ACTIVE",
      "system_prompt": "This wallet collects school fees...",
      "allow_transfers_out": true,
      "sub_account_id": null,
      "created_at": "2026-07-01T11:00:00Z"
    }
  }
  ```
</ResponseExample>