# Sweep 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`.

## Endpoint

`POST /v1/workspace/drive-watches/{watchId}/sweep`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| watchId | path | string | Yes |

## Request body

Content type: `application/json`.

```json
{
  "body": {},
  "params": {
    ":watchId": ""
  },
  "query": {}
}
```

## Responses

### 201

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "landed": 1,
    "note": "string",
    "seen": 1,
    "skipped": 1,
    "watchId": ""
  }
}
```

### default

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.

Content type: `application/json`.

```json
{
  "error": "string"
}
```