Skip to main content

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​

Responses​

successful