# Start Import

```
POST 
/v1/:slug/imports
```

Imports Google Drive or Dropbox folders into a board; the provider is the one of the `source_token` connection. Each folder becomes a sub-board named after it inside the target board, with its sub-folders nested below. Asynchronous: poll Get Import until `status` is `completed` or `canceled`. Each folder is checked against the connected account before the import starts. Re-importing the same folder into the same board skips files already there unchanged (Dropbox files first imported before this skipping shipped are still downloaded again, and are only cleaned up by duplicate merging); a changed file is added next to the old one, and a renamed folder or sub-board is imported again in full. Plans without unrestricted imports allow one active import per workspace, and the refusal names the active import. Storage overage cannot be agreed to through the API: the request is refused when nothing is left before overage the workspace has not agreed to, and the import is canceled with `cancel_reason: overlimit` before storing a file that would cross that level. Returns 429 with `Retry-After` when the provider rate limits the connection, and 502 on other provider errors. Requires workspace owner or admin.

## Request[​](#request "Direct link to request")

## Responses[​](#responses "Direct link to Responses")

* 200
* 401
* 403
* 404
* 422

successful

unauthenticated

not workspace owner or admin

source or board not found

invalid folder, folder not visible to the connected account, connection revoked, another import active, or no storage left before unconsented overage