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

# Settings

View and manage configuration settings for your organization.

## GET /api/v1/clusters/settings

> Get cluster settings

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"schemas":{"ClusterSettingsGetResponse":{"type":"object","properties":{"enableAdvancedGpuMetrics":{"$ref":"#/components/schemas/EnableAdvancedGpuMetricsSetting"}}},"EnableAdvancedGpuMetricsSetting":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true},"displayName":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"stage":{"type":"string","readOnly":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/clusters/settings":{"get":{"summary":"Get cluster settings","operationId":"get_cluster_settings","tags":["Settings"],"responses":{"200":{"description":"Executed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClusterSettingsGetResponse"}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## GET /api/v1/clusters/settings/{key}

> Get cluster setting by key

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"parameters":{"ClusterSettingsKey":{"name":"key","in":"path","required":true,"description":"The settings key","schema":{"$ref":"#/components/schemas/ClusterSettingsKeyEnum"}}},"schemas":{"ClusterSettingsKeyEnum":{"type":"string","enum":["enableAdvancedGpuMetrics"]},"EnableAdvancedGpuMetricsSetting":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true},"displayName":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"stage":{"type":"string","readOnly":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404NotFound":{"description":"The specified resource was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/clusters/settings/{key}":{"get":{"summary":"Get cluster setting by key","operationId":"get_cluster_setting_by_key","tags":["Settings"],"parameters":[{"$ref":"#/components/parameters/ClusterSettingsKey"}],"responses":{"200":{"description":"Executed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnableAdvancedGpuMetricsSetting"}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"404":{"$ref":"#/components/responses/404NotFound"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## PUT /api/v1/clusters/settings/{key}

> Update cluster setting by key

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"parameters":{"ClusterSettingsKey":{"name":"key","in":"path","required":true,"description":"The settings key","schema":{"$ref":"#/components/schemas/ClusterSettingsKeyEnum"}}},"schemas":{"ClusterSettingsKeyEnum":{"type":"string","enum":["enableAdvancedGpuMetrics"]},"UpdateClusterSettingByKeyRequest":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404NotFound":{"description":"The specified resource was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/clusters/settings/{key}":{"put":{"summary":"Update cluster setting by key","operationId":"update_cluster_setting_by_key","tags":["Settings"],"parameters":[{"$ref":"#/components/parameters/ClusterSettingsKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateClusterSettingByKeyRequest"}}}},"responses":{"200":{"description":"Setting successfully updated"},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"404":{"$ref":"#/components/responses/404NotFound"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## GET /api/v1/node-pools/settings

> Get node pool settings

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"schemas":{"NodePoolSettingsGetResponse":{"type":"object","properties":{"projectManualOverQuota":{"$ref":"#/components/schemas/NodePoolSetting"},"cpuResourcesQuota":{"$ref":"#/components/schemas/NodePoolSetting"}}},"NodePoolSetting":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true},"displayName":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"stage":{"type":"string","readOnly":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/node-pools/settings":{"get":{"summary":"Get node pool settings","operationId":"get_node_pool_settings","tags":["Settings"],"responses":{"200":{"description":"Executed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodePoolSettingsGetResponse"}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## GET /api/v1/node-pools/settings/{key}

> Get node pool setting by key

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"parameters":{"NodePoolSettingsKey":{"name":"key","in":"path","required":true,"description":"The settings key","schema":{"$ref":"#/components/schemas/NodePoolSettingsKeyEnum"}}},"schemas":{"NodePoolSettingsKeyEnum":{"type":"string","enum":["projectManualOverQuota","cpuResourcesQuota"]},"NodePoolSetting":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true},"displayName":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"stage":{"type":"string","readOnly":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404NotFound":{"description":"The specified resource was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/node-pools/settings/{key}":{"get":{"summary":"Get node pool setting by key","operationId":"get_node_pool_setting_by_key","tags":["Settings"],"parameters":[{"$ref":"#/components/parameters/NodePoolSettingsKey"}],"responses":{"200":{"description":"Executed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodePoolSetting"}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"404":{"$ref":"#/components/responses/404NotFound"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## PUT /api/v1/node-pools/settings/{key}

> Update node pool setting by key

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"parameters":{"NodePoolSettingsKey":{"name":"key","in":"path","required":true,"description":"The settings key","schema":{"$ref":"#/components/schemas/NodePoolSettingsKeyEnum"}}},"schemas":{"NodePoolSettingsKeyEnum":{"type":"string","enum":["projectManualOverQuota","cpuResourcesQuota"]},"UpdateNodePoolSettingByKeyRequest":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404NotFound":{"description":"The specified resource was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/node-pools/settings/{key}":{"put":{"summary":"Update node pool setting by key","operationId":"update_node_pool_setting_by_key","tags":["Settings"],"parameters":[{"$ref":"#/components/parameters/NodePoolSettingsKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateNodePoolSettingByKeyRequest"}}}},"responses":{"200":{"description":"Setting successfully updated"},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"404":{"$ref":"#/components/responses/404NotFound"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## GET /api/v1/authorization/settings

> Get authorization settings

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"schemas":{"AuthorizationSettingsGetResponse":{"type":"object","properties":{"enableScopedAuthorization":{"$ref":"#/components/schemas/EnableScopedAuthorizationSetting"},"tenantIsCspManaged":{"$ref":"#/components/schemas/TenantIsCspManagedSetting"}}},"EnableScopedAuthorizationSetting":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true}}},"TenantIsCspManagedSetting":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/authorization/settings":{"get":{"summary":"Get authorization settings","operationId":"get_authorization_settings","tags":["Settings"],"responses":{"200":{"description":"Executed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationSettingsGetResponse"}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## GET /api/v1/authorization/settings/{key}

> Get authorization setting by key

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"parameters":{"AuthorizationSettingsKey":{"name":"key","in":"path","required":true,"description":"The settings key","schema":{"$ref":"#/components/schemas/AuthorizationSettingsKeyEnum"}}},"schemas":{"AuthorizationSettingsKeyEnum":{"type":"string","enum":["enableScopedAuthorization","tenantIsCspManaged"]},"EnableScopedAuthorizationSetting":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404NotFound":{"description":"The specified resource was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/authorization/settings/{key}":{"get":{"summary":"Get authorization setting by key","operationId":"get_authorization_setting_by_key","tags":["Settings"],"parameters":[{"$ref":"#/components/parameters/AuthorizationSettingsKey"}],"responses":{"200":{"description":"Executed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnableScopedAuthorizationSetting"}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"404":{"$ref":"#/components/responses/404NotFound"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## PUT /api/v1/authorization/settings/{key}

> Update authorization setting by key

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"parameters":{"AuthorizationSettingsKey":{"name":"key","in":"path","required":true,"description":"The settings key","schema":{"$ref":"#/components/schemas/AuthorizationSettingsKeyEnum"}}},"schemas":{"AuthorizationSettingsKeyEnum":{"type":"string","enum":["enableScopedAuthorization","tenantIsCspManaged"]},"UpdateAuthorizationSettingByKeyRequest":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404NotFound":{"description":"The specified resource was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/authorization/settings/{key}":{"put":{"summary":"Update authorization setting by key","operationId":"update_authorization_setting_by_key","tags":["Settings"],"parameters":[{"$ref":"#/components/parameters/AuthorizationSettingsKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAuthorizationSettingByKeyRequest"}}}},"responses":{"200":{"description":"Setting successfully updated"},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"404":{"$ref":"#/components/responses/404NotFound"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## GET /api/v1/security/settings

> Get security settings

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"schemas":{"SettingsGetResponse":{"type":"object","properties":{"autoRedirectSSO":{"$ref":"#/components/schemas/GetAutoRedirectSsoSetting"},"browserSessionTimeout":{"$ref":"#/components/schemas/GetBrowserSessionTimeoutSetting"},"logoutRedirectUri":{"$ref":"#/components/schemas/GetLogoutRedirectUriSetting"}}},"GetAutoRedirectSsoSetting":{"type":"object","properties":{"value":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true},"idpAlias":{"type":"string","pattern":"^[a-z0-9_-]*$","nullable":true,"maxLength":255}}},"displayName":{"type":"string","description":"Human-readable name for this setting","readOnly":true},"description":{"type":"string","description":"Description of what this setting controls","readOnly":true}}},"GetBrowserSessionTimeoutSetting":{"type":"object","properties":{"value":{"type":"object","properties":{"idleTimeout":{"type":"number","description":"Duration in minutes that a user can remain inactive before their browser session automatically expires and requires re-authentication","default":0,"minimum":0,"maximum":10080,"nullable":true}}},"displayName":{"type":"string","description":"Human-readable name for this setting","readOnly":true},"description":{"type":"string","description":"Description of what this setting controls","readOnly":true}}},"GetLogoutRedirectUriSetting":{"type":"object","properties":{"value":{"type":"object","properties":{"uri":{"type":"string","description":"The URI where users will be redirected after logging out of the application","nullable":true,"pattern":"/^(https?://)?([a-zA-Z0-9.-]+\\.[a-zA-Z]{2,})(:[0-9]{1,5})?(/[^\\s]*)?$|^$/","maxLength":2048}}},"displayName":{"type":"string","description":"Human-readable name for this setting","readOnly":true},"description":{"type":"string","description":"Description of what this setting controls","readOnly":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/security/settings":{"get":{"summary":"Get security settings","operationId":"get_security_settings","tags":["Settings"],"responses":{"200":{"description":"Executed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsGetResponse"}}}},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## GET /api/v1/security/settings/{key}

> Get security setting by key

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"parameters":{"settingsKey":{"name":"key","in":"path","required":true,"description":"The settings key","schema":{"$ref":"#/components/schemas/settingsKeyEnum"}}},"schemas":{"settingsKeyEnum":{"type":"string","enum":["autoRedirectSSO","browserSessionTimeout","logoutRedirectUri"]},"Settings":{"type":"object","additionalProperties":true,"minProperties":0,"maxProperties":50},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404NotFound":{"description":"The specified resource was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/security/settings/{key}":{"get":{"summary":"Get security setting by key","operationId":"get_security_setting_by_key","tags":["Settings"],"parameters":[{"$ref":"#/components/parameters/settingsKey"}],"responses":{"200":{"description":"Executed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Settings"}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"404":{"$ref":"#/components/responses/404NotFound"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## PUT /api/v1/security/settings/{key}

> Update security setting by key

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"parameters":{"settingsKey":{"name":"key","in":"path","required":true,"description":"The settings key","schema":{"$ref":"#/components/schemas/settingsKeyEnum"}}},"schemas":{"settingsKeyEnum":{"type":"string","enum":["autoRedirectSSO","browserSessionTimeout","logoutRedirectUri"]},"UpdateAutoRedirectSsoSettingValue":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true},"idpAlias":{"type":"string","pattern":"^[a-z0-9_-]*$","nullable":true,"maxLength":255}}},"UpdateBrowserSessionTimeoutSettingValue":{"type":"object","properties":{"idleTimeout":{"type":"number","description":"Duration in minutes that a user can remain inactive before their browser session automatically expires and requires re-authentication","default":0,"minimum":0,"maximum":10080,"nullable":true}}},"UpdateLogoutRedirectUriSettingValue":{"type":"object","properties":{"uri":{"type":"string","description":"The URI where users will be redirected after logging out of the application","nullable":true,"pattern":"/^(https?://)?([a-zA-Z0-9.-]+\\.[a-zA-Z]{2,})(:[0-9]{1,5})?(/[^\\s]*)?$|^$/","maxLength":2048}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404NotFound":{"description":"The specified resource was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/security/settings/{key}":{"put":{"summary":"Update security setting by key","operationId":"update_security_setting_by_key","tags":["Settings"],"parameters":[{"$ref":"#/components/parameters/settingsKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/UpdateAutoRedirectSsoSettingValue"},{"$ref":"#/components/schemas/UpdateBrowserSessionTimeoutSettingValue"},{"$ref":"#/components/schemas/UpdateLogoutRedirectUriSettingValue"}]}}}},"responses":{"200":{"description":"Setting successfully updated"},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"404":{"$ref":"#/components/responses/404NotFound"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## Get all workloads settings.

> Retrieve the current values of all workloads-related settings for the tenant.

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"schemas":{"WorkloadsSettingsGetResponse":{"type":"object","properties":{"enablePolicies":{"$ref":"#/components/schemas/GetEnablePolicies"},"workloadSubmissionV2Enabled":{"$ref":"#/components/schemas/GetWorkloadSubmissionV2Enabled"},"enableTemplatesV2":{"$ref":"#/components/schemas/GetEnableTemplatesV2"},"enableHybridSubmission":{"$ref":"#/components/schemas/GetEnableHybridSubmission"},"gpuOverProvisioning":{"$ref":"#/components/schemas/GetGpuOverProvisioning"},"applicationSubmission":{"$ref":"#/components/schemas/GetApplicationSubmission"}}},"GetEnablePolicies":{"type":"object","properties":{"value":{"$ref":"#/components/schemas/GetEnableSettingsValue"},"displayName":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"stage":{"type":"string","readOnly":true}}},"GetEnableSettingsValue":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true}}},"GetWorkloadSubmissionV2Enabled":{"type":"object","properties":{"value":{"$ref":"#/components/schemas/GetEnableSettingsValue"},"displayName":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"stage":{"type":"string","readOnly":true}}},"GetEnableTemplatesV2":{"type":"object","properties":{"value":{"$ref":"#/components/schemas/GetEnableSettingsValue"},"displayName":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"stage":{"type":"string","readOnly":true}}},"GetEnableHybridSubmission":{"type":"object","properties":{"value":{"$ref":"#/components/schemas/GetEnableSettingsValue"},"displayName":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"stage":{"type":"string","readOnly":true}}},"GetGpuOverProvisioning":{"type":"object","properties":{"value":{"$ref":"#/components/schemas/GetEnableSettingsValue"},"displayName":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"stage":{"type":"string","readOnly":true}}},"GetApplicationSubmission":{"type":"object","properties":{"value":{"$ref":"#/components/schemas/GetEnableSettingsValue"},"displayName":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"stage":{"type":"string","readOnly":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/workloads/settings":{"get":{"summary":"Get all workloads settings.","description":"Retrieve the current values of all workloads-related settings for the tenant.","operationId":"get_workloads_service_settings","tags":["Settings"],"responses":{"200":{"description":"Request completed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkloadsSettingsGetResponse"}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## Get a workloads setting by key.

> Retrieve the current value of a specific workloads setting by its key.

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"schemas":{"WorkloadsSettingsKeyEnum":{"type":"string","enum":["enablePolicies","workloadSubmissionV2Enabled","enableTemplatesV2","enableHybridSubmission","gpuOverProvisioning","applicationSubmission"]},"GetWorkloadsSetting":{"type":"object","properties":{"value":{"$ref":"#/components/schemas/GetEnableSettingsValue"},"displayName":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"stage":{"type":"string","readOnly":true}}},"GetEnableSettingsValue":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/workloads/settings/{key}":{"get":{"summary":"Get a workloads setting by key.","description":"Retrieve the current value of a specific workloads setting by its key.","operationId":"get_workloads_service_setting_by_key","tags":["Settings"],"parameters":[{"name":"key","in":"path","required":true,"schema":{"$ref":"#/components/schemas/WorkloadsSettingsKeyEnum"}}],"responses":{"200":{"description":"Request completed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetWorkloadsSetting"}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## Update a workloads setting by key.

> Update the value of a specific workloads setting by its key.

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"schemas":{"WorkloadsSettingsKeyEnum":{"type":"string","enum":["enablePolicies","workloadSubmissionV2Enabled","enableTemplatesV2","enableHybridSubmission","gpuOverProvisioning","applicationSubmission"]},"UpdateWorkloadsSettingByKeyRequest":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/workloads/settings/{key}":{"put":{"summary":"Update a workloads setting by key.","description":"Update the value of a specific workloads setting by its key.","operationId":"update_workloads_service_setting_by_key","tags":["Settings"],"parameters":[{"name":"key","in":"path","required":true,"schema":{"$ref":"#/components/schemas/WorkloadsSettingsKeyEnum"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWorkloadsSettingByKeyRequest"}}}},"responses":{"200":{"description":"Request completed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWorkloadsSettingByKeyRequest"}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## GET /api/v2/workloads/settings

> Get workloads settings

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"schemas":{"WorkloadsSettingsGetResponse1":{"type":"object","properties":{"yamlSubmission":{"$ref":"#/components/schemas/GetYamlSubmission"}}},"GetYamlSubmission":{"type":"object","properties":{"value":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true}}},"displayName":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"stage":{"type":"string","readOnly":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v2/workloads/settings":{"get":{"summary":"Get workloads settings","operationId":"get_workloads_settings","tags":["Settings"],"responses":{"200":{"description":"Executed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkloadsSettingsGetResponse1"}}}},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## GET /api/v2/workloads/settings/{key}

> Get workloads setting by key

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"parameters":{"WorkloadSettingsKey":{"name":"key","in":"path","required":true,"description":"The settings key","schema":{"$ref":"#/components/schemas/WorkloadsSettingsKeyEnum1"}}},"schemas":{"WorkloadsSettingsKeyEnum1":{"type":"string","enum":["yamlSubmission"]},"GetYamlSubmission":{"type":"object","properties":{"value":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true}}},"displayName":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"stage":{"type":"string","readOnly":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404NotFound":{"description":"The specified resource was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v2/workloads/settings/{key}":{"get":{"summary":"Get workloads setting by key","operationId":"get_workloads_setting_by_key","tags":["Settings"],"parameters":[{"$ref":"#/components/parameters/WorkloadSettingsKey"}],"responses":{"200":{"description":"Executed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetYamlSubmission"}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"404":{"$ref":"#/components/responses/404NotFound"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## PUT /api/v2/workloads/settings/{key}

> Update workloads setting by key

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"parameters":{"WorkloadSettingsKey":{"name":"key","in":"path","required":true,"description":"The settings key","schema":{"$ref":"#/components/schemas/WorkloadsSettingsKeyEnum1"}}},"schemas":{"WorkloadsSettingsKeyEnum1":{"type":"string","enum":["yamlSubmission"]},"YamlSubmissionSetting":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404NotFound":{"description":"The specified resource was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v2/workloads/settings/{key}":{"put":{"summary":"Update workloads setting by key","operationId":"update_workloads_setting_by_key","tags":["Settings"],"parameters":[{"$ref":"#/components/parameters/WorkloadSettingsKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/YamlSubmissionSetting"}}}},"responses":{"200":{"description":"Setting successfully updated"},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"404":{"$ref":"#/components/responses/404NotFound"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## GET /api/v1/datavolumes/settings

> Get datavolumes settings

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"schemas":{"DatavolumesSettingsGetResponse":{"type":"object","properties":{"enableDataVolumes":{"$ref":"#/components/schemas/GetEnableDataVolumes"}}},"GetEnableDataVolumes":{"type":"object","properties":{"value":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true}}},"displayName":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"stage":{"type":"string","readOnly":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/datavolumes/settings":{"get":{"summary":"Get datavolumes settings","operationId":"get_datavolumes_settings","tags":["Settings"],"responses":{"200":{"description":"Executed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatavolumesSettingsGetResponse"}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## GET /api/v1/datavolumes/settings/{key}

> Get datavolumes setting by key

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"parameters":{"DatavolumesSettingsKey":{"name":"key","in":"path","required":true,"description":"The settings key","schema":{"$ref":"#/components/schemas/DatavolumesSettingsKeyEnum"}}},"schemas":{"DatavolumesSettingsKeyEnum":{"type":"string","enum":["enableDataVolumes"]},"GetEnableDataVolumes":{"type":"object","properties":{"value":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true}}},"displayName":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"stage":{"type":"string","readOnly":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404NotFound":{"description":"The specified resource was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/datavolumes/settings/{key}":{"get":{"summary":"Get datavolumes setting by key","operationId":"get_datavolumes_setting_by_key","tags":["Settings"],"parameters":[{"$ref":"#/components/parameters/DatavolumesSettingsKey"}],"responses":{"200":{"description":"Executed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetEnableDataVolumes"}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"404":{"$ref":"#/components/responses/404NotFound"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## PUT /api/v1/datavolumes/settings/{key}

> Update datavolumes setting by key

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"parameters":{"DatavolumesSettingsKey":{"name":"key","in":"path","required":true,"description":"The settings key","schema":{"$ref":"#/components/schemas/DatavolumesSettingsKeyEnum"}}},"schemas":{"DatavolumesSettingsKeyEnum":{"type":"string","enum":["enableDataVolumes"]},"UpdateDatavolumesSettingByKeyRequest":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404NotFound":{"description":"The specified resource was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/datavolumes/settings/{key}":{"put":{"summary":"Update datavolumes setting by key","operationId":"update_datavolumes_setting_by_key","tags":["Settings"],"parameters":[{"$ref":"#/components/parameters/DatavolumesSettingsKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDatavolumesSettingByKeyRequest"}}}},"responses":{"200":{"description":"Setting successfully updated"},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"404":{"$ref":"#/components/responses/404NotFound"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## Get notifications settings

> Returns all notifications-related settings for the tenant.

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"schemas":{"NotificationsSettingsGetAllResponse":{"type":"object","description":"Aggregated response containing all notifications settings configured for the tenant","properties":{"adminMessage":{"$ref":"#/components/schemas/GetAdminMessage"}}},"GetAdminMessage":{"type":"object","properties":{"value":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the admin message"},"msg":{"type":"string","description":"The message content displayed to users. Supports a limited HTML subset for basic formatting"},"createdAt":{"type":"integer","format":"int64","description":"Time the message was created, as a Unix timestamp"},"enableDismiss":{"type":"boolean","description":"When true, users can dismiss the message from; when false, the message persists until it is updated or removed"}}},"displayName":{"type":"string","description":"Human-readable name for this setting","readOnly":true},"description":{"type":"string","description":"Short explanation of what this setting controls, shown alongside the setting","readOnly":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/notifications/settings":{"get":{"summary":"Get notifications settings","description":"Returns all notifications-related settings for the tenant.","operationId":"get_notifications_settings","tags":["Settings"],"responses":{"200":{"description":"Executed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationsSettingsGetAllResponse"}}}},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## Get notifications setting by key

> Returns a single notifications setting identified by the path key.

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"parameters":{"notificationsSettingsKey":{"name":"key","in":"path","required":true,"description":"Identifier of the notifications setting to retrieve or update.","schema":{"$ref":"#/components/schemas/notificationsSettingsKeyEnum"}}},"schemas":{"notificationsSettingsKeyEnum":{"type":"string","enum":["adminMessage"]},"GetSettingResponse":{"type":"object","description":"Dynamic settings response that varies by setting key"},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404NotFound":{"description":"The specified resource was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/notifications/settings/{key}":{"get":{"summary":"Get notifications setting by key","description":"Returns a single notifications setting identified by the path key.","operationId":"get_notifications_setting_by_key","tags":["Settings"],"parameters":[{"$ref":"#/components/parameters/notificationsSettingsKey"}],"responses":{"200":{"description":"Executed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetSettingResponse"}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"404":{"$ref":"#/components/responses/404NotFound"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## Update notifications setting by key

> Updates a single notifications setting identified by the path key.

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"parameters":{"notificationsSettingsKey":{"name":"key","in":"path","required":true,"description":"Identifier of the notifications setting to retrieve or update.","schema":{"$ref":"#/components/schemas/notificationsSettingsKeyEnum"}}},"schemas":{"notificationsSettingsKeyEnum":{"type":"string","enum":["adminMessage"]},"UpdateAdminMessage":{"type":"object","properties":{"msg":{"type":"string","nullable":true,"description":"The message content displayed to users. Supports a limited HTML subset for basic formatting"},"enableDismiss":{"type":"boolean","nullable":true,"description":"When true, users can dismiss the message from; when false, the message persists until it is updated or removed"}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404NotFound":{"description":"The specified resource was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/notifications/settings/{key}":{"put":{"summary":"Update notifications setting by key","description":"Updates a single notifications setting identified by the path key.","operationId":"update_notifications_setting_by_key","tags":["Settings"],"parameters":[{"$ref":"#/components/parameters/notificationsSettingsKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/UpdateAdminMessage"}]}}}},"responses":{"200":{"description":"Setting successfully updated"},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"404":{"$ref":"#/components/responses/404NotFound"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## Get branding settings

> Returns all branding-related settings for the tenant.

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"schemas":{"BrandingSettingsGetAllResponse":{"type":"object","description":"Aggregated response containing all branding settings configured for the tenant","properties":{"logo":{"$ref":"#/components/schemas/GetLogo"}}},"GetLogo":{"type":"object","properties":{"value":{"type":"object","properties":{"logo":{"type":"string","description":"Logo image returned as a base64-encoded string. PNG and SVG formats are supported"}}},"displayName":{"type":"string","description":"Human-readable name for this setting","readOnly":true},"description":{"type":"string","description":"Short explanation of what this setting controls, shown alongside the setting","readOnly":true}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/branding/settings":{"get":{"summary":"Get branding settings","description":"Returns all branding-related settings for the tenant.","operationId":"get_branding_settings","tags":["Settings"],"responses":{"200":{"description":"Executed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandingSettingsGetAllResponse"}}}},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## Get branding setting by key

> Returns a single branding setting identified by the path key.

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"parameters":{"brandingSettingsKey":{"name":"key","in":"path","required":true,"description":"Identifier of the branding setting to retrieve or update","schema":{"$ref":"#/components/schemas/brandingSettingsKeyEnum"}}},"schemas":{"brandingSettingsKeyEnum":{"type":"string","enum":["logo"]},"GetSettingResponse":{"type":"object","description":"Dynamic settings response that varies by setting key"},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404NotFound":{"description":"The specified resource was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/branding/settings/{key}":{"get":{"summary":"Get branding setting by key","description":"Returns a single branding setting identified by the path key.","operationId":"get_branding_setting_by_key","parameters":[{"$ref":"#/components/parameters/brandingSettingsKey"}],"tags":["Settings"],"responses":{"200":{"description":"Executed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetSettingResponse"}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"404":{"$ref":"#/components/responses/404NotFound"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```

## Update branding setting by key

> Updates a single branding setting identified by the path key.

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.26"},"tags":[{"name":"Settings","description":"View and manage configuration settings for your organization.\n"}],"servers":[{"url":"https://app.run.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication"}},"parameters":{"brandingSettingsKey":{"name":"key","in":"path","required":true,"description":"Identifier of the branding setting to retrieve or update","schema":{"$ref":"#/components/schemas/brandingSettingsKeyEnum"}}},"schemas":{"brandingSettingsKeyEnum":{"type":"string","enum":["logo"]},"UpdateLogo":{"type":"object","required":["logo"],"properties":{"logo":{"type":"string","description":"Logo image as a base64-encoded string. Accepts PNG or SVG up to 128 KB. Send an empty string to reset the logo"}}},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","minimum":100,"maximum":599},"message":{"type":"string"},"details":{"type":"string"}}}},"responses":{"400BadRequest":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404NotFound":{"description":"The specified resource was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413RequestEntityTooLarge":{"description":"Request entity too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415UnsupportedMediaType":{"description":"Unsupported media type","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500InternalServerError":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503ServiceUnavailable":{"description":"unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/branding/settings/{key}":{"put":{"summary":"Update branding setting by key","description":"Updates a single branding setting identified by the path key.","operationId":"update_branding_setting_by_key","tags":["Settings"],"parameters":[{"$ref":"#/components/parameters/brandingSettingsKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/UpdateLogo"}]}}}},"responses":{"200":{"description":"Setting successfully updated."},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"},"404":{"$ref":"#/components/responses/404NotFound"},"413":{"$ref":"#/components/responses/413RequestEntityTooLarge"},"415":{"$ref":"#/components/responses/415UnsupportedMediaType"},"500":{"$ref":"#/components/responses/500InternalServerError"},"503":{"$ref":"#/components/responses/503ServiceUnavailable"}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://run-ai-docs.nvidia.com/api/2.26/organizations/settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.