---
title: "Move or copy personal capsules into an organization workspace"
method: POST
path: "/api/preview/capsules/batch/move-to-workspace"
tags: ["capsule"]
---

# Move or copy personal capsules into an organization workspace

`POST /api/preview/capsules/batch/move-to-workspace`

## 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/move-to-workspace`
- 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: Personal capsule UUIDs to move or copy
  - `confirm_exposure` boolean: Set true to proceed. Without it the request is refused with a 409 `exposure_requires_confirm` stating who in the organization will see the content, the live links that keep working and the collections left behind, and nothing changes.
  - `mode` 'move' | 'copy': move (default) re-homes the capsules in place; copy leaves the originals and adds copies
  - `targetTypeId` string, required: Type in that workspace the capsules land in
  - `targetWorkspaceId` string, required: Organization workspace to move or copy into

## Response `200`

Successful response

- object
  - `failed` object[], required
    - `code` string, required
    - `error` string, required
    - `id` string, required: UUID v4 string
  - `succeeded` object[], required
    - `capsuleId` string, required: UUID v4 string
    - `droppedCollections` object[], required
      - `id` string, required: UUID v4 string
      - `name` string, required
      - `slug` string, required
    - `id` string, required: UUID v4 string
    - `mode` 'move' | 'copy', required
    - `newRefId` integer, required
    - `newSlug` string, nullable, required
    - `previousRefId` integer, nullable, required
    - `previousSlug` string, nullable, required
    - `typeId` string, required: UUID v4 string
    - `workspaceId` string, required: UUID v4 string

## Changes

- **2026-10-09** `c7729725d527`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/symbol/apis/symbol-api/changes/api/preview/capsules/batch/move-to-workspace/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)