---
title: "Preview Bulk Transfer"
method: POST
path: "/api/agents/transfer/bulk-preview"
tags: ["agent-transfer"]
---

# Preview Bulk Transfer

`POST /api/agents/transfer/bulk-preview`

## Request

- Base URL: `https://api.tintin-x.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tintin-x.com/api/agents/transfer/bulk-preview`
- Auth: HTTP bearer

Build per-agent previews + cross-agent totals for a bulk transfer.

## Request body

- BulkTransferPreviewRequest
  - `to_email` string, email, required
  - `agent_ids` string[], required

## Response `200`

Successful Response

- BulkTransferPreview
  - `to_email` string, required
  - `recipient_exists` boolean, required
  - `recipient_team_id` string, uuid, nullable
  - `same_user` boolean
  - `agents` BulkTransferPreviewItem[]
    - `agent_id` string, uuid, required
    - `agent_name` string, nullable
    - `preview` TransferPreview: What sender sees before creating an invitation.
      - `agent_id` string, uuid, required
      - `to_email` string, required
      - `recipient_exists` boolean, required
      - `recipient_team_id` string, uuid, nullable
      - `same_user` boolean
      - `vault_credentials` TransferableResource[]
        - `id` string, uuid, required
        - `label` string, required
        - `detail` string, nullable
        - `team_owned` boolean
      - `bitables` TransferableResource[]
        - `id` string, uuid, required
        - `label` string, required
        - `detail` string, nullable
        - `team_owned` boolean
      - `bitable_templates` TransferableResource[]
        - `id` string, uuid, required
        - `label` string, required
        - `detail` string, nullable
        - `team_owned` boolean
      - `storage_files` TransferableResource[]
        - `id` string, uuid, required
        - `label` string, required
        - `detail` string, nullable
        - `team_owned` boolean
      - `storage_folders` TransferableResource[]
        - `id` string, uuid, required
        - `label` string, required
        - `detail` string, nullable
        - `team_owned` boolean
      - `elements` TransferableResource[]
        - `id` string, uuid, required
        - `label` string, required
        - `detail` string, nullable
        - `team_owned` boolean
      - `skill_forks` TransferableResource[]
        - `id` string, uuid, required
        - `label` string, required
        - `detail` string, nullable
        - `team_owned` boolean
      - `datahub_jobs` TransferableResource[]
        - `id` string, uuid, required
        - `label` string, required
        - `detail` string, nullable
        - `team_owned` boolean
      - `user_scoped_memories` TransferableResource[]
        - `id` string, uuid, required
        - `label` string, required
        - `detail` string, nullable
        - `team_owned` boolean
      - `oauth_services` TransferableResource[]
        - `id` string, uuid, required
        - `label` string, required
        - `detail` string, nullable
        - `team_owned` boolean
      - `caveats` TransferCaveat[]
        - `code` string, required
        - `message` string, required
    - `error` string, nullable
  - `totals` object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tintin-x/apis/tintin-api.md) · [All operations](https://skmtc.dev/tintin-x/apis/tintin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tintin-x/apis/tintin-api/revisions/8839a8d0a66c?raw)