# This file was auto-generated by Fern from our API Definition.
import typing
from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
from ...core.request_options import RequestOptions
from ...types.project_group_request import ProjectGroupRequest
from ...types.scim_settings import ScimSettings
from ...types.scim_settings_update import ScimSettingsUpdate
from .raw_client import AsyncRawScimClient, RawScimClient
# this is used as the default value for optional parameters
OMIT = typing.cast(typing.Any, ...)
class ScimClient:
def __init__(self, *, client_wrapper: SyncClientWrapper):
self._raw_client = RawScimClient(client_wrapper=client_wrapper)
@property
def with_raw_response(self) -> RawScimClient:
"""
Retrieves a raw implementation of this client that returns raw responses.
Returns
-------
RawScimClient
"""
return self._raw_client
def get(self, *, request_options: typing.Optional[RequestOptions] = None) -> ScimSettings:
"""
This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)
Retrieve SCIM settings for the currently active organization.
Parameters
----------
request_options : typing.Optional[RequestOptions]
Request-specific configuration.
Returns
-------
ScimSettings
Examples
--------
from label_studio_sdk import LabelStudio
client = LabelStudio(
api_key="YOUR_API_KEY",
)
client.sso.scim.get()
"""
_response = self._raw_client.get(request_options=request_options)
return _response.data
def update(
self,
*,
projects_groups: typing.Optional[typing.Sequence[ProjectGroupRequest]] = OMIT,
roles_groups: typing.Optional[typing.Sequence[typing.Sequence[str]]] = OMIT,
workspaces_groups: typing.Optional[typing.Sequence[typing.Sequence[str]]] = OMIT,
request_options: typing.Optional[RequestOptions] = None,
) -> ScimSettingsUpdate:
"""
This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)
Update SCIM settings for the currently active organization.
Parameters
----------
projects_groups : typing.Optional[typing.Sequence[ProjectGroupRequest]]
Projects to Groups Mapping. List of objects with project_id, group, role.
roles_groups : typing.Optional[typing.Sequence[typing.Sequence[str]]]
Organization Roles to Groups Mapping. List of [role_name, group_name] pairs.
workspaces_groups : typing.Optional[typing.Sequence[typing.Sequence[str]]]
Workspaces to Groups Mapping. List of [workspace_title, group_name] pairs.
request_options : typing.Optional[RequestOptions]
Request-specific configuration.
Returns
-------
ScimSettingsUpdate
Examples
--------
from label_studio_sdk import LabelStudio, ProjectGroupRequest
client = LabelStudio(
api_key="YOUR_API_KEY",
)
client.sso.scim.update(
projects_groups=[
ProjectGroupRequest(
group="groups_test",
project_id=42,
role="Inherit",
)
],
roles_groups=[["Administrator", "groups_test"]],
workspaces_groups=[["Default workspace", "groups_test"]],
)
"""
_response = self._raw_client.update(
projects_groups=projects_groups,
roles_groups=roles_groups,
workspaces_groups=workspaces_groups,
request_options=request_options,
)
return _response.data
class AsyncScimClient:
def __init__(self, *, client_wrapper: AsyncClientWrapper):
self._raw_client = AsyncRawScimClient(client_wrapper=client_wrapper)
@property
def with_raw_response(self) -> AsyncRawScimClient:
"""
Retrieves a raw implementation of this client that returns raw responses.
Returns
-------
AsyncRawScimClient
"""
return self._raw_client
async def get(self, *, request_options: typing.Optional[RequestOptions] = None) -> ScimSettings:
"""
This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)
Retrieve SCIM settings for the currently active organization.
Parameters
----------
request_options : typing.Optional[RequestOptions]
Request-specific configuration.
Returns
-------
ScimSettings
Examples
--------
import asyncio
from label_studio_sdk import AsyncLabelStudio
client = AsyncLabelStudio(
api_key="YOUR_API_KEY",
)
async def main() -> None:
await client.sso.scim.get()
asyncio.run(main())
"""
_response = await self._raw_client.get(request_options=request_options)
return _response.data
async def update(
self,
*,
projects_groups: typing.Optional[typing.Sequence[ProjectGroupRequest]] = OMIT,
roles_groups: typing.Optional[typing.Sequence[typing.Sequence[str]]] = OMIT,
workspaces_groups: typing.Optional[typing.Sequence[typing.Sequence[str]]] = OMIT,
request_options: typing.Optional[RequestOptions] = None,
) -> ScimSettingsUpdate:
"""
This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)
Update SCIM settings for the currently active organization.
Parameters
----------
projects_groups : typing.Optional[typing.Sequence[ProjectGroupRequest]]
Projects to Groups Mapping. List of objects with project_id, group, role.
roles_groups : typing.Optional[typing.Sequence[typing.Sequence[str]]]
Organization Roles to Groups Mapping. List of [role_name, group_name] pairs.
workspaces_groups : typing.Optional[typing.Sequence[typing.Sequence[str]]]
Workspaces to Groups Mapping. List of [workspace_title, group_name] pairs.
request_options : typing.Optional[RequestOptions]
Request-specific configuration.
Returns
-------
ScimSettingsUpdate
Examples
--------
import asyncio
from label_studio_sdk import AsyncLabelStudio, ProjectGroupRequest
client = AsyncLabelStudio(
api_key="YOUR_API_KEY",
)
async def main() -> None:
await client.sso.scim.update(
projects_groups=[
ProjectGroupRequest(
group="groups_test",
project_id=42,
role="Inherit",
)
],
roles_groups=[["Administrator", "groups_test"]],
workspaces_groups=[["Default workspace", "groups_test"]],
)
asyncio.run(main())
"""
_response = await self._raw_client.update(
projects_groups=projects_groups,
roles_groups=roles_groups,
workspaces_groups=workspaces_groups,
request_options=request_options,
)
return _response.data