---
title: "Undo one of your bulk moves, tag edits or tag renames. A rename undo puts back exactly the tags each capsule had; capsules that cannot be undone are reported in skipped."
method: POST
path: "/api/preview/history/batches/{batchId}/revert"
tags: ["history"]
---

# Undo one of your bulk moves, tag edits or tag renames. A rename undo puts back exactly the tags each capsule had; capsules that cannot be undone are reported in skipped.

`POST /api/preview/history/batches/{batchId}/revert`

## 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/history/batches/{batchId}/revert`
- 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`

## Path parameters

- `batchId` string, required: UUID v4 string

## Response `200`

Successful response

- object: What undoing a history batch did.
  - `batch_id` string, required: UUID v4 string
  - `reverted` string[], required: Capsules this request undid.
  - `reverted_at` string, nullable, required: Set once nothing of the batch is left to undo.
  - `skipped` object[], required: Capsules left as they are, each with why. `already_reverted` is not an error: a retried request reports it.
    - `capsule_id` string, required: UUID v4 string
    - `reason` 'already_reverted' | 'forbidden' | 'changed_since' | 'expired' | 'source_type_gone' | 'cross_workspace_move' | 'log_type_target' | 'target_not_writable' | 'values_invalid' | 'alias_taken' | 'attachment_purged' | 'derived_alias' | 'capsule_archived' | 'move_refused' | 'project_unavailable' | 'collection_unavailable' | 'attachment_no_room' | 'tag_limit', required

## Changes

- **2026-10-19** `5778844d1f9e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/symbol/apis/symbol-api/changes/api/preview/history/batches/:batchId/revert/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)