> For the complete documentation index, see [llms.txt](https://docs.rigoblock.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rigoblock.com/operator-settings.md).

# Operator Settings

Operator-scoped safety settings — requires vault ownership proof, bypasses the LLM

## Set default slippage tolerance

> Operator-only endpoint to set the default slippage tolerance (0.1%–5%). Does not involve the chat LLM; the UI settings panel calls this directly.

```json
{"openapi":"3.1.0","info":{"title":"Rigoblock","version":"1.0.0"},"tags":[{"name":"Operator Settings","description":"Operator-scoped safety settings — requires vault ownership proof, bypasses the LLM"}],"servers":[{"url":"https://trader.rigoblock.com","description":"Production"}],"paths":{"/api/settings/slippage":{"post":{"operationId":"setSlippage","summary":"Set default slippage tolerance","description":"Operator-only endpoint to set the default slippage tolerance (0.1%–5%). Does not involve the chat LLM; the UI settings panel calls this directly.","tags":["Operator Settings"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatorSettingsRequest"}}}},"responses":{"200":{"description":"Slippage updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized"}}}}},"components":{"schemas":{"OperatorSettingsRequest":{"type":"object","required":["vaultAddress","chainId","operatorAddress","authSignature","authTimestamp"],"properties":{"vaultAddress":{"type":"string","description":"Vault contract address"},"chainId":{"type":"integer","description":"Chain ID where the vault exists"},"operatorAddress":{"type":"string","description":"Vault owner address"},"authSignature":{"type":"string","description":"EIP-191 signature of the auth message"},"authTimestamp":{"type":"integer","description":"Timestamp included in the signed auth message"},"slippage":{"type":"string","description":"Slippage value (e.g. '0.5%', '50bps', or '0.5')"},"tolerance":{"type":"string","description":"Swap Shield tolerance percentage (e.g. '30%')"},"threshold":{"type":"string","description":"NAV Shield threshold percentage (e.g. '15%')"},"reset":{"type":"boolean","description":"When true, reset the setting to its default value"}}},"SettingsResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}
```

## Set or reset Swap Shield tolerance

> Operator-only endpoint to temporarily raise the Swap Shield tolerance (up to 50% for 10 minutes) or reset it to the default 5%. Does not involve the chat LLM.

```json
{"openapi":"3.1.0","info":{"title":"Rigoblock","version":"1.0.0"},"tags":[{"name":"Operator Settings","description":"Operator-scoped safety settings — requires vault ownership proof, bypasses the LLM"}],"servers":[{"url":"https://trader.rigoblock.com","description":"Production"}],"paths":{"/api/settings/swap-shield":{"post":{"operationId":"setSwapShieldTolerance","summary":"Set or reset Swap Shield tolerance","description":"Operator-only endpoint to temporarily raise the Swap Shield tolerance (up to 50% for 10 minutes) or reset it to the default 5%. Does not involve the chat LLM.","tags":["Operator Settings"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatorSettingsRequest"}}}},"responses":{"200":{"description":"Swap Shield tolerance updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized"}}}}},"components":{"schemas":{"OperatorSettingsRequest":{"type":"object","required":["vaultAddress","chainId","operatorAddress","authSignature","authTimestamp"],"properties":{"vaultAddress":{"type":"string","description":"Vault contract address"},"chainId":{"type":"integer","description":"Chain ID where the vault exists"},"operatorAddress":{"type":"string","description":"Vault owner address"},"authSignature":{"type":"string","description":"EIP-191 signature of the auth message"},"authTimestamp":{"type":"integer","description":"Timestamp included in the signed auth message"},"slippage":{"type":"string","description":"Slippage value (e.g. '0.5%', '50bps', or '0.5')"},"tolerance":{"type":"string","description":"Swap Shield tolerance percentage (e.g. '30%')"},"threshold":{"type":"string","description":"NAV Shield threshold percentage (e.g. '15%')"},"reset":{"type":"boolean","description":"When true, reset the setting to its default value"}}},"SettingsResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}
```

## Set or reset NAV Shield threshold

> Operator-only endpoint to set the NAV Shield maximum loss threshold (1%–100%) or reset it to the default 10%. Does not involve the chat LLM.

```json
{"openapi":"3.1.0","info":{"title":"Rigoblock","version":"1.0.0"},"tags":[{"name":"Operator Settings","description":"Operator-scoped safety settings — requires vault ownership proof, bypasses the LLM"}],"servers":[{"url":"https://trader.rigoblock.com","description":"Production"}],"paths":{"/api/settings/nav-shield":{"post":{"operationId":"setNavShieldThreshold","summary":"Set or reset NAV Shield threshold","description":"Operator-only endpoint to set the NAV Shield maximum loss threshold (1%–100%) or reset it to the default 10%. Does not involve the chat LLM.","tags":["Operator Settings"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatorSettingsRequest"}}}},"responses":{"200":{"description":"NAV Shield threshold updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized"}}}}},"components":{"schemas":{"OperatorSettingsRequest":{"type":"object","required":["vaultAddress","chainId","operatorAddress","authSignature","authTimestamp"],"properties":{"vaultAddress":{"type":"string","description":"Vault contract address"},"chainId":{"type":"integer","description":"Chain ID where the vault exists"},"operatorAddress":{"type":"string","description":"Vault owner address"},"authSignature":{"type":"string","description":"EIP-191 signature of the auth message"},"authTimestamp":{"type":"integer","description":"Timestamp included in the signed auth message"},"slippage":{"type":"string","description":"Slippage value (e.g. '0.5%', '50bps', or '0.5')"},"tolerance":{"type":"string","description":"Swap Shield tolerance percentage (e.g. '30%')"},"threshold":{"type":"string","description":"NAV Shield threshold percentage (e.g. '15%')"},"reset":{"type":"boolean","description":"When true, reset the setting to its default value"}}},"SettingsResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}
```

## Get execution mode preference

> Returns the operator's current auto-execute preference (autonomous or confirm). Shared between the web UI and Telegram.

```json
{"openapi":"3.1.0","info":{"title":"Rigoblock","version":"1.0.0"},"tags":[{"name":"Operator Settings","description":"Operator-scoped safety settings — requires vault ownership proof, bypasses the LLM"}],"servers":[{"url":"https://trader.rigoblock.com","description":"Production"}],"paths":{"/api/settings/exec-mode":{"get":{"operationId":"getExecMode","summary":"Get execution mode preference","description":"Returns the operator's current auto-execute preference (autonomous or confirm). Shared between the web UI and Telegram.","tags":["Operator Settings"],"parameters":[{"name":"vaultAddress","in":"query","required":true,"schema":{"type":"string"}},{"name":"chainId","in":"query","required":true,"schema":{"type":"integer"}},{"name":"operatorAddress","in":"query","required":true,"schema":{"type":"string"}},{"name":"authSignature","in":"query","required":true,"schema":{"type":"string"}},{"name":"authTimestamp","in":"query","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Current execution mode preference","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecModeResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized"}}}}},"components":{"schemas":{"ExecModeResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"mode":{"type":"string","enum":["autonomous","confirm"]}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}
```

## Set execution mode preference

> Sets whether the operator's trades execute immediately (autonomous) or require confirmation (confirm). Shared between the web UI and Telegram.

```json
{"openapi":"3.1.0","info":{"title":"Rigoblock","version":"1.0.0"},"tags":[{"name":"Operator Settings","description":"Operator-scoped safety settings — requires vault ownership proof, bypasses the LLM"}],"servers":[{"url":"https://trader.rigoblock.com","description":"Production"}],"paths":{"/api/settings/exec-mode":{"post":{"operationId":"setExecMode","summary":"Set execution mode preference","description":"Sets whether the operator's trades execute immediately (autonomous) or require confirmation (confirm). Shared between the web UI and Telegram.","tags":["Operator Settings"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecModeRequest"}}}},"responses":{"200":{"description":"Execution mode preference updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecModeResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized"}}}}},"components":{"schemas":{"ExecModeRequest":{"type":"object","required":["vaultAddress","chainId","operatorAddress","authSignature","authTimestamp","mode"],"properties":{"vaultAddress":{"type":"string","description":"Vault contract address"},"chainId":{"type":"integer","description":"Chain ID where the vault exists"},"operatorAddress":{"type":"string","description":"Vault owner address"},"authSignature":{"type":"string","description":"EIP-191 signature of the auth message"},"authTimestamp":{"type":"integer","description":"Timestamp included in the signed auth message"},"mode":{"type":"string","enum":["autonomous","confirm"],"description":"Autonomous executes trades immediately; confirm requires an explicit approval"}}},"ExecModeResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"mode":{"type":"string","enum":["autonomous","confirm"]}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}
```