# Start a tag migration (internal)

**POST /admin/tags/migrate**

Queues a job that backfills the tag links (`attachedTags`) from the legacy tag fields of the listed `collections` (every registered collection when omitted), `batchSize` documents at a time (50 to 5000, 1000 by default), optionally as a `dryRun`. Returns the queued job, or 400 for a collection that is not registered. Super admin only.


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Access token


## Parameters



### Body: application/json (object)

- **collections** (array[string])
  Specific collections to migrate. Empty/omitted = all 20.

- **batchSize** (number)

- **dryRun** (boolean)



## Responses
### 201


#### Body: application/json (object)
- **data** (object)

- **statusCode** (number)

- **timestamp** (string(date-time))



[Powered by Bump.sh](https://bump.sh)