# \SettingsApi
All URIs are relative to */api*
[**backend_version**](SettingsApi.md#backend_version) | **GET** /version | get backend version
[**get_brand_name**](SettingsApi.md#get_brand_name) | **GET** /brand_name | get the public brand name
[**get_entitlements**](SettingsApi.md#get_entitlements) | **GET** /entitlements | get the instance (host) licence's tier and limits
[**get_license_id**](SettingsApi.md#get_license_id) | **GET** /ee_license | get license id
[**get_open_api_yaml**](SettingsApi.md#get_open_api_yaml) | **GET** /openapi.yaml | get openapi yaml spec
[**get_workspace_entitlements**](SettingsApi.md#get_workspace_entitlements) | **GET** /w/{workspace}/entitlements | get the licence answering for this workspace
[**list_features**](SettingsApi.md#list_features) | **GET** /features | list enabled feature keys, the ORVANTA_BETA toggle, and the capability catalog
[**list_workspace_features**](SettingsApi.md#list_workspace_features) | **GET** /w/{workspace}/features | list this workspace's enabled feature keys and capability catalog
## backend_version
> String backend_version()
get backend version
### Parameters
This endpoint does not need any parameter.
### Return type
**String**
### Authorization
[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: text/plain
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## get_brand_name
> String get_brand_name()
get the public brand name
The operator-set whitelabel name for pre-login pages. Unauthenticated; exposes only the sanitized (max 40 chars) `whitelabel_name` instance setting, never licence data.
### Parameters
This endpoint does not need any parameter.
### Return type
**String**
### Authorization
[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: text/plain
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## get_entitlements
> models::GetEntitlements200Response get_entitlements()
get the instance (host) licence's tier and limits
### Parameters
This endpoint does not need any parameter.
### Return type
[**models::GetEntitlements200Response**](getEntitlements_200_response.md)
### Authorization
[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## get_license_id
> String get_license_id()
get license id
### Parameters
This endpoint does not need any parameter.
### Return type
**String**
### Authorization
[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: text/plain
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## get_open_api_yaml
> String get_open_api_yaml()
get openapi yaml spec
### Parameters
This endpoint does not need any parameter.
### Return type
**String**
### Authorization
[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: text/plain
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## get_workspace_entitlements
> models::WorkspaceEntitlements get_workspace_entitlements(workspace)
get the licence answering for this workspace
Read-only (#1753). Managed licence mode: the workspace's own licence (Trial and `state: missing` when none is held). Instance mode: the instance licence, shared by every workspace. Members of the workspace only; a non-member is refused exactly as for a workspace that does not exist. Seat allowances/usage and the ladder dates (`seats`, `seats_used`, `first_failure_at`, `grace_deadline`, `missing_since`) are returned to workspace admins only and are `null` for other members (#1953).
### Parameters
**workspace** | **String** | | [required] |
### Return type
[**models::WorkspaceEntitlements**](WorkspaceEntitlements.md)
### Authorization
[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## list_features
> models::FeatureCatalogResponse list_features()
list enabled feature keys, the ORVANTA_BETA toggle, and the capability catalog
### Parameters
This endpoint does not need any parameter.
### Return type
[**models::FeatureCatalogResponse**](FeatureCatalogResponse.md)
### Authorization
No authorization required
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## list_workspace_features
> models::FeatureCatalogResponse list_workspace_features(workspace)
list this workspace's enabled feature keys and capability catalog
Same shape as `/features`, answered by the licence of this workspace (#1753): its own for a workspace-scoped capability in managed licence mode (Trial when none is held), the host's for an instance-scoped one, and the instance licence for everything in instance mode. Members of the workspace only.
### Parameters
**workspace** | **String** | | [required] |
### Return type
[**models::FeatureCatalogResponse**](FeatureCatalogResponse.md)
### Authorization
[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)