Start Google Drive Import
POST/v1/:slug/imports
Imports Google Drive folders into a board. 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 Google account before the import starts. Re-importing the same folder into the same board skips files already there unchanged; 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 Google rate limits the connection, and 502 on other Google errors. Requires workspace owner or admin.
Request
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