# Remove a stored setting

Source: https://api-docs.magicdoor.com/api-reference/settings/remove-setting

Deletes the row stored at one level for one settings type, so that entity falls back to whatever its parent level says. Point it at `company` and the company drops back to MagicDoor's built-in default. Requires the `settings:delete` permission.

`DELETE https://services.magicdoor.com/settings/company-portal/settings/{settingsType}/{level}/{levelId}`

**Authentication:** bearer token in the `Authorization` header, as `Bearer <token>`.

## Path parameters

- `settingsType` (enum<string>, required) — Which family of settings to act on. Matched case-insensitively against the registered settings types. One of: `achpaymentprocessing`, `agentschat`, `associationviolation`, `autopayincentives`, `chat`, `chatai`, `chatailease`, `chataileaserenewal`, `chataileaserentersinsurance`, `chataimaintenancerequests`, `chataitranslation`, `communications`, `company`, `contribution`, `depositpayment`, `distribution`, `email`, `emailnotification`, `latefees`, `leasechartofaccount`, `leaseinvoice`, `leaserenewal`, `leaserentersinsurance`, `maintenancerequest`, `maintenancerequestrunbook`, `managementfee`, `outgoingpayments`, `property`, `rentalapplication`, `rentalapplicationbilling`, `rentalapplicationchartofaccount`, `rentalapplicationgeneral`, `rentalapplicationpayment`, `rentalapplicationpaymentaccount`, `rentalapplicationquestionnaire`, `rentalapplicationscreening`, `rentpayment`, `rentpaymentfailurefee`, `rentpaymentnotification`, `rentpaymentprocessingfees`, `syndication`, `tenantautopayfailednotification`, `tenantpaymentreminder`, `text`, `workorder`. Example: `property`.
- `level` (enum<string>, required) — The kind of entity the setting is attached to. Matched case-insensitively. One of: `company`, `portfolio`, `property`, `unit`, `lease`. Example: `property`.
- `levelId` (string, required) — The entity whose stored row should be removed, of the kind named by `level`. A Snowflake id, sent as a whole number in the URL. Example: `1842918365109710848`.

## Example request

```bash
curl --request DELETE \
  --url 'https://services.magicdoor.com/settings/company-portal/settings/property/property/1842918365109710848' \
  --header 'Authorization: Bearer <token>'
```

## Responses

### 200 — The row was removed, or there was nothing stored to remove. The response has no body.

### 401 — The access token is missing, expired, or invalid.

### 403 — The caller does not hold the `settings:delete` permission.

### 404 — No settings type is registered under the `settingsType` in the URL.

```json
{
  "type": "https://httpstatuses.com/404",
  "title": "Not Found",
  "status": 404,
  "detail": "Unknown settings type: propertysettings",
  "instance": "/company-portal/settings/propertysettings/company",
  "traceId": "0HN7GK9C2M4PQ"
}
```

> **Note:**
>
> Deleting a row that was never stored is not an error — the call succeeds and nothing changes. If the row belongs to a group, only this one row is removed and the rest of the group stays.