/v1/workspace/drive-watchesWatch a Drive folder
Start watching a Google Drive folder, and say where its new files should land: {folderId, targetKind, ...}. targetKind is one of definition_row (with definitionKey + rowId), board_row (with boardRowId) or workspace (the document library, no record at all). An optional documentType stamps every document the folder lands. provider is google_drive (the default) or onedrive; a OneDrive folder (from GET /v1/workspace/onedrive-folders, with driveId for a SharePoint library) is read with the caller's own Microsoft connection before the watch exists, and the sweep reads it with that same connection. One watch per folder per workspace - a second is a 409. Watching starts immediately; the first sweep runs within a few minutes or on demand.
Access class: workspace:admin.
Send request
Use the documented inputs to call this endpoint directly.
Request body
application/jsonrequiredResponses
the action's answer
{
"data": {
"boardRowId": "",
"createdAt": "2026-01-01T00:00:00Z",
"createdBy": 1,
"definitionId": "",
"definitionKey": "string",
"documentType": "string",
"driveId": "",
"filesLanded": 1,
"folderId": "",
"folderName": "string",
"id": "",
"lastSweepError": "string",
"lastSweepLanded": 1,
"lastSweptAt": "2026-01-01T00:00:00Z",
"provider": "string",
"rowId": "",
"targetKind": "string",
"updatedAt": "2026-01-01T00:00:00Z"
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}