# Settings

Canonical HTML: https://anchorshell.com/docs/settings

Adjust Relay defaults, estimate-based admission, and request-payload storage.

Last updated: 2026-09-17

Settings control runtime defaults, estimation, and optional request-payload storage. They affect future requests; storing bodies is separate from keeping usage metadata.

## Dashboard

1. Open **Settings**.
2. Review the settings you want to change.
3. Set wait, retry, or cooldown defaults as needed.
4. Choose whether to reserve estimated tokens and spending against limits.
5. Save your changes.

Leave **Store request payloads** off unless you need body inspection. Payloads can contain sensitive data.

Hosted Settings also includes limit-view preferences and request characterization. View preferences do not change the limits themselves. Self-hosted environment settings are covered in [Self-hosted](https://anchorshell.com/docs/self-hosting).

## API

Use an appropriately scoped [API key](https://anchorshell.com/docs/api) for these requests.

### Read settings

```bash
curl 'https://api.anchorshell.com/api/relay/settings' \
  -H 'Authorization: Bearer <API_KEY>'
```

**Response — 200 OK**

value_json is serialized JSON text, not a native boolean.

```json
[
  {
    "key": "store_requests",
    "value_json": "false",
    "updated_at": "2026-09-17T12:00:00Z"
  }
]
```

### Turn off payload storage

```bash
curl -X PUT 'https://api.anchorshell.com/api/relay/settings/store_requests' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
  "value": false
}'
```

**Response — 204 No Content**

No response body.

Reads require `relay:settings:view`; changes require `relay:settings:manage`.

## Next

[Setup](https://anchorshell.com/docs/setup).