---
title: "Your bulk moves, tag edits and tag renames from the last 30 days, with what can still be undone"
method: GET
path: "/api/preview/history/batches"
tags: ["history"]
---

# Your bulk moves, tag edits and tag renames from the last 30 days, with what can still be undone

`GET /api/preview/history/batches`

## 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`
- 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`

## Query parameters

- `kind` 'move' | 'tags' | 'tag_rename' | 'type_migrate': Only batches of this kind. The Tags page lists `tag_rename`.

## Response `200`

Successful response

- object: The caller's own history batches from the last 30 days, newest first.
  - `batches` object[], required
    - `created_at` string, required
    - `id` string, required: UUID v4 string
    - `kind` 'move' | 'tags' | 'tag_rename' | 'type_migrate', required
    - `made` integer, required: Capsule changes the batch made when it ran.
    - `partly_expired` boolean, required: True when some of its recorded changes were pruned (older than 30 days, or past a capsule's newest 200).
    - `reverted_at` string, nullable, required: Set once nothing of the batch is left to undo.
    - `revertible` integer, required: Capsule changes of the batch that can still be undone.
    - `summary` object, required: What the batch did, by kind: a rename's `{ from, to, merge }`, a move's target Type id, and `changes`, how many capsule changes it recorded.
    - `total` integer, required: Capsule changes of the batch that are still recorded.

## Changes

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

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