Update a wallet | Moov Documentation

Update a wallet

Update properties of an existing wallet such as name, description, status, or metadata.

Read our Moov wallets guide to learn more.

To access this endpoint using an access token you'll need to specify the /accounts/{accountID}/wallets.write scope.

PATCH

/accounts/{accountID}/wallets/{walletID}

Ask

curl -X PATCH "https://api.moov.io/accounts/{accountID}/wallets/{walletID}" \
  -H "Authorization: Bearer {token}" \
  -H "X-Moov-Version: v2026.07.00" \
  -d '{\n  "name": "My second wallet",\n  "description": "My new description",\n  "metadata": {\n    "optional": "metadata"\n  }\n}'

Ask

mc, _ := moov.NewClient()

accountID := "{uuid}" // account ID of the wallet owner
walletID := "{uuid}" // wallet ID of the wallet to update

newName := "My new wallet"
update := moov.UpdateWallet{
    Name: &newName,
}

mc.UpdateWallet(ctx, accountID, walletID, update)

Ask

import { Moov } from "@moovio/sdk";

const moov = new Moov({
  security: {
    username: "",
    password: "",
  },
});

async function run() {
  const result = await moov.wallets.update({
    walletID: "9f1c6e07-aae8-40e6-b290-502bb1bc486e",
    accountID: "e4aad2fb-201d-4390-b4d3-6de7716152e1",
    patchWallet: {
      name: "My second wallet",
      description: "My new description",
      metadata: {
        "optional": "metadata",
      },
    },
  });

console.log(result);
}

run();

Ask

declare(strict_types=1);

require 'vendor/autoload.php';

use Moov\MoovPhp;
use Moov\MoovPhp\Models\Components;

$sdk = MoovPhp\Moov::builder()
    ->setSecurity(
        new Components\Security(
            username: '',
            password: '',
        )
    )
    ->build();

$patchWallet = new Components\PatchWallet(
    name: 'My second wallet',
    description: 'My new description',
    metadata: [\
        'optional' => 'metadata',\
    ],
);

$response = $sdk->wallets->update(
    walletID: '9f1c6e07-aae8-40e6-b290-502bb1bc486e',
    accountID: 'e4aad2fb-201d-4390-b4d3-6de7716152e1',
    patchWallet: $patchWallet
);

if ($response->wallet !== null) {
    // handle response
}

Ask

package hello.world;

import io.moov.sdk.Moov;
import io.moov.sdk.models.components.PatchWallet;
import io.moov.sdk.models.components.Security;
import io.moov.sdk.models.errors.GenericError;
import io.moov.sdk.models.errors.PatchWalletValidationError;
import io.moov.sdk.models.operations.UpdateWalletResponse;
import java.lang.Exception;
import java.util.Map;

public class Application {

public static void main(String[] args) throws GenericError, PatchWalletValidationError, Exception {

Moov sdk = Moov.builder()
                .security(Security.builder()
                    .username("")
                    .password("")
                    .build())
            .build();

UpdateWalletResponse res = sdk.wallets().update()
                .walletID("9f1c6e07-aae8-40e6-b290-502bb1bc486e")
                .accountID("e4aad2fb-201d-4390-b4d3-6de7716152e1")
                .patchWallet(PatchWallet.builder()
                    .name("My second wallet")
                    .description("My new description")
                    .metadata(Map.ofEntries(
                        Map.entry("optional", "metadata")))
                    .build())
                .call();

if (res.wallet().isPresent()) {
            System.out.println(res.wallet().get());
        }
    }
}

Ask

from moovio_sdk import Moov
from moovio_sdk.models import components

with Moov(
    security=components.Security(
        username="",
        password="",
    ),
) as moov:

res = moov.wallets.update(wallet_id="9f1c6e07-aae8-40e6-b290-502bb1bc486e", account_id="e4aad2fb-201d-4390-b4d3-6de7716152e1", name="My second wallet", description="My new description", metadata={
        "optional": "metadata",
    })

# Handle response
    print(res)

Ask

require 'moov_ruby'

Models = ::Moov::Models
s = ::Moov::Client.new(
  security: Models::Components::Security.new(
    username: '',
    password: ''
  )
)
res = s.wallets.update(wallet_id: '9f1c6e07-aae8-40e6-b290-502bb1bc486e', account_id: 'e4aad2fb-201d-4390-b4d3-6de7716152e1', patch_wallet: Models::Components::PatchWallet.new(
  name: 'My second wallet',
  description: 'My new description',
  metadata: {
    'optional' => 'metadata',
  }
))

unless res.wallet.nil?
  # handle response
end

Ask

using Moov.Sdk;
using Moov.Sdk.Models.Components;
using System.Collections.Generic;

var sdk = new MoovClient(security: new Security() {
    Username = "",
    Password = "",
});

var res = await sdk.Wallets.UpdateAsync(
    walletID: "9f1c6e07-aae8-40e6-b290-502bb1bc486e",
    accountID: "e4aad2fb-201d-4390-b4d3-6de7716152e1",
    body: new PatchWallet() {
        Name = "My second wallet",
        Description = "My new description",
        Metadata = new Dictionary<string, string>() {
            { "optional", "metadata" },
        },
    }
);

// handle response