---
title: "Archive or unarchive portfolio accounts"
method: POST
path: "/v1/portfolios/{portfolioSlug}/ledger-accounts/archive/bulk"
tags: ["LedgerAccounts"]
---

# Archive or unarchive portfolio accounts

`POST /v1/portfolios/{portfolioSlug}/ledger-accounts/archive/bulk`

## Request

- Base URL: `https://api.tokenbooks.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tokenbooks.io/v1/portfolios/{portfolioSlug}/ledger-accounts/archive/bulk`
- Auth: API key in header `x-api-key`

Sets active state for unique accounts in the active portfolio. Requires ledger-account update permission and Advanced Ledger; unavailable Advanced Ledger returns HTTP 403 (FeatureNotEnabledError). Existing account safety checks apply.

## Path parameters

- `portfolioSlug` string, required

## Request body

- BulkArchiveLedgerAccountsRequestDto
  - `accountNumbers` string[], required: Ledger account numbers to update
  - `isActive` boolean: Active state to set for all accounts. Defaults to false.

## Response `200`

- BulkArchiveLedgerAccountsResponseDto
  - `accounts` object[], required: Processed accounts in first-seen request order
    - `accountNumber` string, required: Ledger account number
    - `isActive` boolean, required: Active state now in effect

## Other responses

- `409`

---

[API](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api.md) · [All operations](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/revisions/180622e6255e?raw)