---
title: "Preview what archiving capsules would pause (links, public pages, skills, embeds, and access for the people they are shared with) and, per capsule, whether you could archive it"
method: POST
path: "/api/preview/capsules/batch/archive-impact"
tags: ["capsule"]
---

# Preview what archiving capsules would pause (links, public pages, skills, embeds, and access for the people they are shared with) and, per capsule, whether you could archive it

`POST /api/preview/capsules/batch/archive-impact`

## Request

- Base URL: `https://symbol.chat` (the document declares no server; this is the origin it was published from)
- URL: `https://symbol.chat/api/preview/capsules/batch/archive-impact`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Secure-next-auth.session-token`
  - OAuth 2
    - Authorization code: `https://mcp.symbol.chat/authorize`
    - Token URL: `https://mcp.symbol.chat/token`

## Request body

- object
  - `capsuleIds` string[], required: Capsule ids to preview archiving

## Response `200`

Successful response

- object
  - `canResume` boolean, required
  - `embedCount` integer, required
  - `entries` object[], required: One entry per distinct requested id: would_archive, already_archived, cannot_edit (readable but not editable), or not_found (missing or not visible to you).
    - `id` string, required
    - `outcome` 'would_archive' | 'already_archived' | 'cannot_edit' | 'not_found', required
  - `linkCount` integer, required
  - `peopleCount` integer, required: Distinct people the capsules you would archive, and may manage people on, are shared with. They lose access while the capsules are archived. A team capsule its whole organization reads (`org_view`, `org_edit`) is left out: the people it is shared with are members and keep reading it.
  - `peopleHiddenCount` integer, required: How many capsules you would archive without being allowed to see who they are shared with. Anyone they are shared with loses access too. Team capsules its whole organization reads are left out.
  - `publicCount` integer, required
  - `publishedSkillCount` integer, required
  - `total` integer, required: Requested capsules the caller can read.
  - `withActiveShares` integer, required
  - `withPeopleShares` integer, required: Of the capsules you would archive and may manage people on, how many are shared with at least one person who loses access (team capsules its whole organization reads are left out).

## Changes

- **2026-10-27** `3a2c4ebeab51`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/symbol/apis/symbol-api/changes/api/preview/capsules/batch/archive-impact/post.md)

---

[API](https://skmtc.dev/symbol/apis/symbol-api.md) - [All operations](https://skmtc.dev/symbol/apis/symbol-api/llms.txt) - [OpenAPI document](https://skmtc.dev/symbol/apis/symbol-api/revisions/3a2c4ebeab51?raw)
