/v1/workspace/drive-watches/{watchId}/sweepSweep a Drive watch now
List the watched folder right now and land every file this workspace has not already taken out of it, on the watch's target. Answers what it did: how many files the folder held, how many became documents, how many were skipped because they were already landed, and a note naming anything that could not be carried (a file over the size cap, a folder longer than one pass). The same work the scheduled sweep does, so pressing this cannot give a different answer.
Access class: workspace:admin.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
Request body
application/jsonrequiredResponses
the action's answer
{
"data": {
"landed": 1,
"note": "string",
"seen": 1,
"skipped": 1,
"watchId": ""
}
}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"
}