---
title: "Start a folder quota scan"
method: POST
path: "/quotas/folders/{name}/scan"
tags: ["quota"]
---

# Start a folder quota scan

`POST /quotas/folders/{name}/scan`

## Request

- Base URL: `/api/v2` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v2/quotas/folders/{name}/scan`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-SFTPGO-API-KEY`
- TypeScript: <https://skmtc.dev/kanton-bern/apis/sftpgo/docs/quotas/folders/:name/scan/post.ts> (a function with typed inputs; its response is checked against the schema)

Starts a new quota scan for the given folder. A quota scan update the number of files and their total size for the specified folder

## Response `202`

successful operation

- ApiResponse
  - `message` string: message, can be empty
  - `error` string: error description if any

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error
- `default`: Unexpected Error

---

[API](https://skmtc.dev/kanton-bern/apis/sftpgo.md) - [All operations](https://skmtc.dev/kanton-bern/apis/sftpgo/llms.txt) - [OpenAPI document](https://skmtc.dev/kanton-bern/apis/sftpgo/revisions/d8d616a479b0?raw)