---
title: "Unset keys in a remote"
method: POST
path: "/config/unset"
tags: ["config"]
---

# Unset keys in a remote

`POST /config/unset`

## Request

- Base URL: `http://localhost:5572`
- URL: `http://localhost:5572/config/unset`
- Auth: one of:
  - HTTP basic
  - none
- TypeScript: <https://skmtc.dev/rclone/apis/rclone-rc-api/docs/config/unset/post.ts> (a function with typed inputs; its response is checked against the schema)

Removes keys from a remote in the config file.

## Headers

- `Prefer` 'respond-async'

## Request body

- object
  - `_config` object: Config overrides for this call only.
  - `_filter` object: Filter overrides for this call only.
  - `_group` string: Stats group for this call.
  - `name` string, required: Name of the remote.
  - `keys` string[], required: Key names to remove.

## Response `200`

The keys that were removed.

- object
  - `removed` string[], nullable, required: The keys that were removed, or null if none were.

## Other responses

- `202`: The call is running in the background, because the request sent `Prefer: respond-async`. Poll `job/status` with the job ID. A job can be queried for up to 1 minute after it finishes.
- `401`: Missing or wrong credentials. The auth layer sends this as plain text, before rclone's JSON errors apply.
- `4XX`: Any error response (HTTP 4xx/5xx)
- `5XX`: Any error response (HTTP 4xx/5xx)

## Changes

- **2026-10-31** `9abe65975575`: 1 info
  - api tag `config` added
- **2026-10-31** `1d0b982bbbff`: 1 breaking, 2 info
  - the response property `removed` became nullable for the status `200`
  - added the non-success response with the status `401`
  - the response property `removed` became required for the status `200`
- **2026-10-31** `5342b87535b9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rclone/apis/rclone-rc-api/changes/config/unset/post.md)

---

[API](https://skmtc.dev/rclone/apis/rclone-rc-api.md) - [All operations](https://skmtc.dev/rclone/apis/rclone-rc-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rclone/apis/rclone-rc-api/revisions/a7af46c0c706?raw)