Skip to documentation

Settings

Settings

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

Self-hostedHosted

Last updated September 17, 2026

View as Markdown

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.

API

Use an appropriately scoped API key for these requests.

Read settings

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.

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

Turn off payload storage

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.