# Settings

View and manage configuration settings for your organization.

## GET /api/v1/security/settings

> Get security settings

```json
{"openapi":"3.0.3","info":{"title":"NVIDIA Run:ai","version":"2.22"},"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/AutoRedirectSsoSetting"},"excludeGroupsFromTokens":{"$ref":"#/components/schemas/ExcludeGroupsFromTokenSetting"},"browserSessionTimeout":{"$ref":"#/components/schemas/BrowserSessionTimeoutSetting"},"logoutRedirectUri":{"$ref":"#/components/schemas/LogoutRedirectUriSetting"}}},"AutoRedirectSsoSetting":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true},"idpAlias":{"type":"string","pattern":"^[a-z0-9_-]*$","nullable":true}}},"ExcludeGroupsFromTokenSetting":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true}}},"BrowserSessionTimeoutSetting":{"type":"object","description":"Settings for user session timeout configuration that manages automatic logout after periods of inactivity.","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":60,"minimum":1,"nullable":true}}},"LogoutRedirectUriSetting":{"type":"object","description":"Settings for configuring the logout redirect URI that determines where users are redirected after logging out.","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]*)?$|^$/"}}},"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.22"},"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","excludeGroupsFromToken","browserSessionTimeout","logoutRedirectUri"]},"Settings":{"type":"object","additionalProperties":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/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.22"},"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","excludeGroupsFromToken","browserSessionTimeout","logoutRedirectUri"]},"AutoRedirectSsoSetting":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true},"idpAlias":{"type":"string","pattern":"^[a-z0-9_-]*$","nullable":true}}},"ExcludeGroupsFromTokenSetting":{"type":"object","properties":{"enabled":{"type":"boolean","nullable":true}}},"BrowserSessionTimeoutSetting":{"type":"object","description":"Settings for user session timeout configuration that manages automatic logout after periods of inactivity.","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":60,"minimum":1,"nullable":true}}},"LogoutRedirectUriSetting":{"type":"object","description":"Settings for configuring the logout redirect URI that determines where users are redirected after logging out.","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]*)?$|^$/"}}},"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/AutoRedirectSsoSetting"},{"$ref":"#/components/schemas/ExcludeGroupsFromTokenSetting"},{"$ref":"#/components/schemas/BrowserSessionTimeoutSetting"},{"$ref":"#/components/schemas/LogoutRedirectUriSetting"}]}}}},"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"}}}}}}
```