---
title: "Set option values"
method: POST
path: "/options/set"
---

# Set option values

`POST /options/set`

Sets temporary option overrides for the running process by supplying key/value pairs grouped under option block names. Provide one or more query parameters whose names match the blocks you want to modify (for example `main`, `rc`, `http`). Each block parameter carries an object of option overrides.

## Query parameters

- `dlna` object
- `filter` object
- `ftp` object
- `main` object
- `http` object
- `log` object
- `mount` object
- `nfs` object
- `proxy` object
- `rc` object
- `restic` object
- `s3` object
- `sftp` object
- `vfs` object
- `webdav` object
- `_group` string
- `_async` boolean

## Headers

- `Prefer` 'respond-async'

## Request body

- OptionsSetRequest
  - `dlna` object — Overrides for the `dlna` option block.
  - `filter` object — Overrides for the `filter` option block.
  - `ftp` object — Overrides for the `ftp` option block.
  - `main` object — Overrides for the `main` option block.
  - `http` object — Overrides for the `http` option block.
  - `log` object — Overrides for the `log` option block.
  - `mount` object — Overrides for the `mount` option block.
  - `nfs` object — Overrides for the `nfs` option block.
  - `proxy` object — Overrides for the `proxy` option block.
  - `rc` object — Overrides for the `rc` option block.
  - `restic` object — Overrides for the `restic` option block.
  - `s3` object — Overrides for the `s3` option block.
  - `sftp` object — Overrides for the `sftp` option block.
  - `vfs` object — Overrides for the `vfs` option block.
  - `webdav` object — Overrides for the `webdav` option block.
  - `_group` string — Assign the request to a custom stats group.
  - `_async` boolean — Run the command asynchronously. Returns a job id immediately.

## Response `200`

Request succeeded returning an empty JSON object.

- object

## Other responses

- `202` — Request accepted for async processing. Poll /job/status with the returned jobid.
- `4XX` — Any error response (HTTP 4xx/5xx)
- `5XX` — Any error response (HTTP 4xx/5xx)

---

[API](https://skmtc.net/rclone/apis/rclone-rc-api.md) · [All operations](https://skmtc.net/rclone/apis/rclone-rc-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rclone/rclone-rc-api/versions/2849bf2803ce/schema)