---
title: "Import Folder"
method: POST
path: "/api/folders/import"
tags: ["folders", "mcp_excluded"]
---

# Import Folder

`POST /api/folders/import`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/folders/import`
- Auth: none declared

Import a folder from a zip, a folder download or any zip of files (TOS-7356).

Creates a new folder (inside ``parent_id`` when given, which needs admin
there) with the zip's subfolders, and uploads each document through the
normal upload pipeline; with a ``thinqos-folder.json`` manifest it restores
each document's metadata, the members you are allowed to add, and the
skills, connections and agents. Nothing it does widens anyone's access to
anything that already existed. 413 for a zip over 200 MB (packed or
unpacked) or with too many entries; 400 for a path that leaves the folder.

## Headers

- `x-impersonate-identity-id` string, nullable

## Response `201`

Successful Response

- FolderImportOut
  - `folder_id` string, uuid, required
  - `name` string, required
  - `address` string, nullable, required
  - `documents_queued` integer, required
  - `job_ids` string[], required
  - `subfolders_created` integer, required
  - `members_added` integer, required
  - `skills_imported` integer, required
  - `connections_imported` integer, required
  - `agents_imported` integer, required
  - `skipped` FolderImportSkippedOut[], required
    - `kind` string, required
    - `name` string, required
    - `reason` string, required

## Other responses

- `422`: Validation Error

---

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