---
title: "Archive a wallet"
method: POST
path: "/v1/wallets/{wallet_id}/archive"
tags: ["Wallets"]
---

# Archive a wallet

`POST /v1/wallets/{wallet_id}/archive`

Archives a wallet, preventing it from being used in any write or signing operations. Archived wallets are hidden from list endpoints by default. Returns 404 if the wallet does not exist or is already archived.

## Path parameters

- `wallet_id` string, required — ID of the wallet.

## Headers

- `privy-app-id` string, required — ID of your Privy app.

## Response `200`

The archived wallet.

- Wallet — A wallet managed by Privy's wallet infrastructure.
  - `additional_signers` WalletAdditionalSignerItem[], required — Additional signers for the wallet.
    - `override_policy_ids` string[] — An optional list of up to one policy ID to enforce on the wallet.
    - `signer_id` string, cuid2, required — A unique identifier for a key quorum.
  - `address` string, required — Address of the wallet.
  - `archived_at` number, nullable — Unix timestamp of when the wallet was archived in milliseconds, or null if the wallet is active.
  - `authorization_threshold` number — The number of keys that must sign for an action to be valid.
  - `chain_type` 'ethereum' | 'solana' | 'cosmos' | 'stellar' | 'sui' | 'aptos' | 'movement' | 'tron' | 'bitcoin-segwit' | 'bitcoin-taproot' | 'pearl' | 'near' | 'ton' | 'starknet' | 'spark', required — The wallet chain types.
  - `created_at` number, required — Unix timestamp of when the wallet was created in milliseconds.
  - `custody` WalletCustodian — Information about the custodian managing this wallet.
    - `provider` string, required — The custodian responsible for the wallet.
    - `provider_user_id` string, required — The resource ID of the beneficiary of the custodial wallet.
  - `display_name` string — A human-readable label for the wallet.
  - `exported_at` number, nullable, required — Unix timestamp of when the wallet was exported in milliseconds, if the wallet was exported.
  - `external_id` string — A customer-provided identifier for mapping to external systems. Write-once, set only at creation.
  - `id` string, required — Unique ID of the wallet. This will be the primary identifier when using the wallet in the future.
  - `imported_at` number, nullable, required — Unix timestamp of when the wallet was imported in milliseconds, if the wallet was imported.
  - `owner_id` string, cuid2, nullable, required — The key quorum ID of the owner of the wallet.
  - `policy_ids` string[], required — List of policy IDs for policies that are enforced on the wallet.
  - `public_key` string — The compressed, raw public key for the wallet along the chain cryptographic curve.

---

[API](https://skmtc.net/privy-io/apis/privy-api.md) · [All operations](https://skmtc.net/privy-io/apis/privy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/privy-io/privy-api/revisions/bb2eb34156cc/schema)