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

# Settings

## List Runtime settings

> List Runtime namespace settings. Missing rows are returned as schema-defaulted documents with \`configured: false\`.<br>

```json
{"openapi":"3.1.0","info":{"title":"SVX Wallet API","version":"4.0.1"},"servers":[{"url":"https://zyfla-wallet-sandbox.meeco.cloud","description":"SVX Wallet deployment (relative)"}],"security":[{},{"bearerAuth":[]},{"mutualTLS":[]}],"components":{"securitySchemes":{"bearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http"},"mutualTLS":{"type":"mutualTLS"}},"schemas":{"SettingsResponseDto":{"type":"object","properties":{"settings":{"type":"array","items":{"$ref":"#/components/schemas/RuntimeSettingModelDto"}}},"required":["settings"]},"RuntimeSettingModelDto":{"type":"object","properties":{"namespace":{"type":"string","enum":["system","issuer","verifier","bridge","wallets"]},"configured":{"type":"boolean","description":"True when the namespace has a persisted row; derived from `revision != null`."},"revision":{"type":"integer","minimum":1},"document":{"type":"object","additionalProperties":true},"updated_at":{"type":"string","format":"date-time"},"updated_by":{"type":"string"}},"required":["namespace","configured","revision","document","updated_at","updated_by"]}}},"paths":{"/system/settings":{"get":{"summary":"List Runtime settings","description":"List Runtime namespace settings. Missing rows are returned as schema-defaulted documents with `configured: false`.\n","operationId":"SettingsController_findAll","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsResponseDto"}}},"description":"Runtime settings loaded"}},"tags":["Settings"]}}}}
```

## Get effective settings

> Get the merged effective configuration with known Static/bootstrap secrets redacted.<br>

```json
{"openapi":"3.1.0","info":{"title":"SVX Wallet API","version":"4.0.1"},"servers":[{"url":"https://zyfla-wallet-sandbox.meeco.cloud","description":"SVX Wallet deployment (relative)"}],"security":[{},{"bearerAuth":[]},{"mutualTLS":[]}],"components":{"securitySchemes":{"bearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http"},"mutualTLS":{"type":"mutualTLS"}},"schemas":{"EffectiveConfigResponseDto":{"type":"object","properties":{"values":{"type":"object","additionalProperties":true,"description":"Merged effective configuration with known Static/bootstrap secrets redacted."}},"required":["values"]}}},"paths":{"/system/settings/effective":{"get":{"summary":"Get effective settings","description":"Get the merged effective configuration with known Static/bootstrap secrets redacted.\n","operationId":"SettingsController_getEffectiveConfig","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EffectiveConfigResponseDto"}}},"description":"Effective settings loaded"}},"tags":["Settings"]}}}}
```

## Get Runtime setting

> Get one Runtime namespace setting. Missing rows are returned as schema-defaulted documents with \`configured: false\`.<br>

```json
{"openapi":"3.1.0","info":{"title":"SVX Wallet API","version":"4.0.1"},"servers":[{"url":"https://zyfla-wallet-sandbox.meeco.cloud","description":"SVX Wallet deployment (relative)"}],"security":[{},{"bearerAuth":[]},{"mutualTLS":[]}],"components":{"securitySchemes":{"bearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http"},"mutualTLS":{"type":"mutualTLS"}},"schemas":{"SettingResponseDto":{"type":"object","properties":{"setting":{"$ref":"#/components/schemas/RuntimeSettingModelDto"}},"required":["setting"]},"RuntimeSettingModelDto":{"type":"object","properties":{"namespace":{"type":"string","enum":["system","issuer","verifier","bridge","wallets"]},"configured":{"type":"boolean","description":"True when the namespace has a persisted row; derived from `revision != null`."},"revision":{"type":"integer","minimum":1},"document":{"type":"object","additionalProperties":true},"updated_at":{"type":"string","format":"date-time"},"updated_by":{"type":"string"}},"required":["namespace","configured","revision","document","updated_at","updated_by"]},"InvalidPathParamError":{"properties":{"error":{"description":"Unique error identifier","enum":["invalid_path_param"],"type":"string"},"extra_info":{"description":"Object that may contain more information about the error","type":"object"},"message":{"description":"User friendly error message","type":"string"}},"required":["error","message","extra_info"],"type":"object"}}},"paths":{"/system/settings/{namespace}":{"get":{"summary":"Get Runtime setting","description":"Get one Runtime namespace setting. Missing rows are returned as schema-defaulted documents with `configured: false`.\n","operationId":"SettingsController_findOne","parameters":[{"in":"path","name":"namespace","required":true,"schema":{"type":"string","enum":["system","issuer","verifier","bridge","wallets"]}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingResponseDto"}}},"description":"Runtime setting loaded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvalidPathParamError"}}},"description":"Invalid namespace"}},"tags":["Settings"]}}}}
```

## Replace Runtime setting

> Replace one Runtime namespace document. First writes require \`expected\_revision: 0\`; updates require the current revision.<br>

```json
{"openapi":"3.1.0","info":{"title":"SVX Wallet API","version":"4.0.1"},"servers":[{"url":"https://zyfla-wallet-sandbox.meeco.cloud","description":"SVX Wallet deployment (relative)"}],"security":[{},{"bearerAuth":[]},{"mutualTLS":[]}],"components":{"securitySchemes":{"bearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http"},"mutualTLS":{"type":"mutualTLS"}},"schemas":{"UpdateSettingRequestDto":{"type":"object","properties":{"document":{"type":"object","additionalProperties":true},"expected_revision":{"type":"integer","minimum":0}},"required":["document","expected_revision"]},"SettingResponseDto":{"type":"object","properties":{"setting":{"$ref":"#/components/schemas/RuntimeSettingModelDto"}},"required":["setting"]},"RuntimeSettingModelDto":{"type":"object","properties":{"namespace":{"type":"string","enum":["system","issuer","verifier","bridge","wallets"]},"configured":{"type":"boolean","description":"True when the namespace has a persisted row; derived from `revision != null`."},"revision":{"type":"integer","minimum":1},"document":{"type":"object","additionalProperties":true},"updated_at":{"type":"string","format":"date-time"},"updated_by":{"type":"string"}},"required":["namespace","configured","revision","document","updated_at","updated_by"]},"InvalidPathParamError":{"properties":{"error":{"description":"Unique error identifier","enum":["invalid_path_param"],"type":"string"},"extra_info":{"description":"Object that may contain more information about the error","type":"object"},"message":{"description":"User friendly error message","type":"string"}},"required":["error","message","extra_info"],"type":"object"},"InvalidRequestPayloadError":{"properties":{"error":{"description":"Unique error identifier","enum":["invalid_request_payload"],"type":"string"},"extra_info":{"description":"Object that may contain more information about the error","type":"object"},"message":{"description":"User friendly error message","type":"string"}},"required":["error","message","extra_info"],"type":"object"},"SettingsRevisionConflictError":{"properties":{"error":{"description":"Unique error identifier","enum":["settings_revision_conflict"],"type":"string"},"extra_info":{"description":"Object that contains namespace and revision conflict details","type":"object","properties":{"namespace":{"type":"string","enum":["system","issuer","verifier","bridge","wallets"]},"expected_revision":{"type":"integer","minimum":0},"current_revision":{"type":"integer"}}},"message":{"description":"User friendly error message","type":"string"}},"required":["error","message","extra_info"],"type":"object"}}},"paths":{"/system/settings/{namespace}":{"put":{"summary":"Replace Runtime setting","description":"Replace one Runtime namespace document. First writes require `expected_revision: 0`; updates require the current revision.\n","operationId":"SettingsController_update","parameters":[{"in":"path","name":"namespace","required":true,"schema":{"type":"string","enum":["system","issuer","verifier","bridge","wallets"]}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSettingRequestDto"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingResponseDto"}}},"description":"Runtime setting replaced"},"400":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/InvalidPathParamError"},{"$ref":"#/components/schemas/InvalidRequestPayloadError"}]}}},"description":"Invalid namespace, body, or Runtime document"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsRevisionConflictError"}}},"description":"Runtime setting revision conflict"}},"tags":["Settings"]}}}}
```

## Reset Runtime setting

> Reset one Runtime namespace to defaults. Requires \`expected\_revision\`; missing namespace with \`expected\_revision: 0\` is the only no-op reset.<br>

```json
{"openapi":"3.1.0","info":{"title":"SVX Wallet API","version":"4.0.1"},"servers":[{"url":"https://zyfla-wallet-sandbox.meeco.cloud","description":"SVX Wallet deployment (relative)"}],"security":[{},{"bearerAuth":[]},{"mutualTLS":[]}],"components":{"securitySchemes":{"bearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http"},"mutualTLS":{"type":"mutualTLS"}},"schemas":{"ResetSettingRequestDto":{"type":"object","properties":{"expected_revision":{"type":"integer","minimum":0}},"required":["expected_revision"]},"SettingResponseDto":{"type":"object","properties":{"setting":{"$ref":"#/components/schemas/RuntimeSettingModelDto"}},"required":["setting"]},"RuntimeSettingModelDto":{"type":"object","properties":{"namespace":{"type":"string","enum":["system","issuer","verifier","bridge","wallets"]},"configured":{"type":"boolean","description":"True when the namespace has a persisted row; derived from `revision != null`."},"revision":{"type":"integer","minimum":1},"document":{"type":"object","additionalProperties":true},"updated_at":{"type":"string","format":"date-time"},"updated_by":{"type":"string"}},"required":["namespace","configured","revision","document","updated_at","updated_by"]},"InvalidPathParamError":{"properties":{"error":{"description":"Unique error identifier","enum":["invalid_path_param"],"type":"string"},"extra_info":{"description":"Object that may contain more information about the error","type":"object"},"message":{"description":"User friendly error message","type":"string"}},"required":["error","message","extra_info"],"type":"object"},"InvalidRequestPayloadError":{"properties":{"error":{"description":"Unique error identifier","enum":["invalid_request_payload"],"type":"string"},"extra_info":{"description":"Object that may contain more information about the error","type":"object"},"message":{"description":"User friendly error message","type":"string"}},"required":["error","message","extra_info"],"type":"object"},"SettingsRevisionConflictError":{"properties":{"error":{"description":"Unique error identifier","enum":["settings_revision_conflict"],"type":"string"},"extra_info":{"description":"Object that contains namespace and revision conflict details","type":"object","properties":{"namespace":{"type":"string","enum":["system","issuer","verifier","bridge","wallets"]},"expected_revision":{"type":"integer","minimum":0},"current_revision":{"type":"integer"}}},"message":{"description":"User friendly error message","type":"string"}},"required":["error","message","extra_info"],"type":"object"}}},"paths":{"/system/settings/{namespace}":{"delete":{"summary":"Reset Runtime setting","description":"Reset one Runtime namespace to defaults. Requires `expected_revision`; missing namespace with `expected_revision: 0` is the only no-op reset.\n","operationId":"SettingsController_reset","parameters":[{"in":"path","name":"namespace","required":true,"schema":{"type":"string","enum":["system","issuer","verifier","bridge","wallets"]}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetSettingRequestDto"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingResponseDto"}}},"description":"Runtime setting reset to defaults"},"400":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/InvalidPathParamError"},{"$ref":"#/components/schemas/InvalidRequestPayloadError"}]}}},"description":"Invalid namespace or body"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsRevisionConflictError"}}},"description":"Runtime setting revision conflict"}},"tags":["Settings"]}}}}
```