Skip to content

Sharing Groups

add_org_to_sharing_group async

add_org_to_sharing_group(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))
    ],
    db: Annotated[Session, Depends(get_db)],
    id: int,
    body: AddOrgToSharingGroupBody,
) -> SharingGroupOrgSchema

Add an organisation to a sharing group.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))]

Authentication details

required
db Annotated[Session, Depends(get_db)]

Database session.

required
id int

ID of the sharing group to add the organisation

required
body AddOrgToSharingGroupBody

Request body containing organisation details

required

Returns:

Name Type Description
SharingGroupOrgSchema SharingGroupOrg

Representation of the added organisation in the sharing group

add_org_to_sharing_group_legacy async

add_org_to_sharing_group_legacy(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))
    ],
    db: Annotated[Session, Depends(get_db)],
    id: Annotated[int, Path(alias=sharingGroupId)],
    organisation_id: Annotated[
        int, Path(alias=organisationId)
    ],
    body: AddOrgToSharingGroupLegacyBody = AddOrgToSharingGroupLegacyBody(),
) -> StandardStatusResponse

Add an organisation to a sharing group.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))]

Authentication details

required
db Annotated[Session, Depends(get_db)]

Database session

required
id Annotated[int, Path(alias=sharingGroupId)]

ID of the sharing group to add the organisation

required
organisation_id Annotated[int, Path(alias=organisationId)]

ID of the organisation to add

required
body AddOrgToSharingGroupLegacyBody

Request body containing additional details

AddOrgToSharingGroupLegacyBody()

Returns:

Name Type Description
StandardStatusResponse StandardStatusResponse

Response indicating success or failure

add_server_to_sharing_group async

add_server_to_sharing_group(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))
    ],
    db: Annotated[Session, Depends(get_db)],
    id: int,
    body: AddServerToSharingGroupBody,
) -> dict

Add a server to a sharing group.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))]

Authentication details

required
db Annotated[Session, Depends(get_db)]

Database session

required
id int

ID of the sharing group to add the server

required
body AddServerToSharingGroupBody

Request body containing server details

required

Returns:

Type Description
dict

Representation of the added server in the sharing group

add_server_to_sharing_group_legacy async

add_server_to_sharing_group_legacy(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))
    ],
    db: Annotated[Session, Depends(get_db)],
    id: Annotated[int, Path(alias=sharingGroupId)],
    server_id: Annotated[int, Path(alias=serverId)],
    body: AddServerToSharingGroupLegacyBody = AddServerToSharingGroupLegacyBody(),
) -> StandardStatusResponse

Add a server to a sharing group.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))]

Authentication details

required
db Annotated[Session, Depends(get_db)]

Database session

required
id Annotated[int, Path(alias=sharingGroupId)]

ID of the sharing group to add the server

required
server_id Annotated[int, Path(alias=serverId)]

ID of the server to add

required
body AddServerToSharingGroupLegacyBody

Request body containing additional details

AddServerToSharingGroupLegacyBody()

Returns:

Name Type Description
StandardStatusResponse StandardStatusResponse

Response indicating success or failure

create_sharing_group async

create_sharing_group(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))
    ],
    db: Annotated[Session, Depends(get_db)],
    body: CreateSharingGroupBody,
) -> dict

Add a new sharing group with given details.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))]

Authentication details

required
db Annotated[Session, Depends(get_db)]

Database session

required
body CreateSharingGroupBody

Request body containing details for creating the sharing group

required

Returns:

Type Description
dict

Details of the created sharing group

create_sharing_group_legacy async

create_sharing_group_legacy(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))
    ],
    db: Annotated[Session, Depends(get_db)],
    body: CreateSharingGroupLegacyBody,
) -> dict

Add a new sharing group with given details.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))]

Authentication details

required
db Annotated[Session, Depends(get_db)]

Database session

required
body CreateSharingGroupLegacyBody

Request body containing details for creating the sharing group

required

Returns:

Type Description
dict

Representation of the created sharing group

delete_sharing_group async

delete_sharing_group(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))
    ],
    db: Annotated[Session, Depends(get_db)],
    id: int,
) -> dict

Delete a specific sharing group.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))]

Authentication details

required
db Annotated[Session, Depends(get_db)]

Database session

required
id int

ID of the sharing group to delete

required

Returns:

Type Description
dict

Representation of the deleted sharing group

delete_sharing_group_legacy async

delete_sharing_group_legacy(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))
    ],
    db: Annotated[Session, Depends(get_db)],
    id: Annotated[int, Path(alias=sharingGroupId)],
) -> dict

Delete a specific sharing group.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))]

Authentication details

required
db Annotated[Session, Depends(get_db)]

Database session

required
id Annotated[int, Path(alias=sharingGroupId)]

ID of the sharing group to delete

required

Returns:

Type Description
dict

Representation of the deleted sharing group

get_all_sharing_groups async

get_all_sharing_groups(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))
    ],
    db: Annotated[Session, Depends(get_db)],
) -> GetSharingGroupsIndex

Retrieve a list of all sharing groups.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))]

Authentication details

required
db Annotated[Session, Depends(get_db)]

Database session

required

Returns:

Type Description
GetSharingGroupsIndex

Representation of all sharing groups

get_sharing_group async

get_sharing_group(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))
    ],
    db: Annotated[Session, Depends(get_db)],
    id: int | UUID,
) -> dict

Retrieve details of a specific sharing group.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))]

Authentication details

required
db Annotated[Session, Depends(get_db)]

Database session

required
id int | UUID

ID of the sharing group to retrieve

required

Returns:

Type Description
dict

Representation of the sharing group details

get_sharing_group_info async

get_sharing_group_info(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))
    ],
    db: Annotated[Session, Depends(get_db)],
    id: int,
) -> dict

Details of a sharing group and org.count, user_count and created_by_email.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))]

Authentication details

required
db Annotated[Session, Depends(get_db)]

Database session

required
id int

ID of the sharing group to retrieve additional information

required

Returns:

Type Description
dict

Representation of the sharing group information

remove_org_from_sharing_group async

remove_org_from_sharing_group(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))
    ],
    db: Annotated[Session, Depends(get_db)],
    id: int,
    organisation_id: Annotated[
        int, Path(alias=organisationId)
    ],
) -> dict

Remove an organisation from a sharing group

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))]

Authentication details

required
db Annotated[Session, Depends(get_db)]

Database session.

required
id int

ID of the sharing group to remove the organisation

required
organisation_id Annotated[int, Path(alias=organisationId)]

ID of the organisation to remove

required

Returns:

Type Description
dict

Representation of the removed organisation from the sharing group

remove_org_from_sharing_group_legacy async

remove_org_from_sharing_group_legacy(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))
    ],
    db: Annotated[Session, Depends(get_db)],
    id: Annotated[int, Path(alias=sharingGroupId)],
    organisation_id: Annotated[
        int, Path(alias=organisationId)
    ],
) -> StandardStatusResponse

Remove an organisation from a sharing group.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))]

Authentication details

required
db Annotated[Session, Depends(get_db)]

Database session

required
id Annotated[int, Path(alias=sharingGroupId)]

ID of the sharing group to remove the organisation from

required
organisation_id Annotated[int, Path(alias=organisationId)]

ID of the organisation to remove

required

Returns:

Name Type Description
StandardStatusResponse StandardStatusResponse

Response indicating success or failure

remove_server_from_sharing_group async

remove_server_from_sharing_group(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))
    ],
    db: Annotated[Session, Depends(get_db)],
    id: int,
    server_id: Annotated[int, Path(alias=serverId)],
) -> dict

Remove a server from a sharing group.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))]

Authentication details

required
db Annotated[Session, Depends(get_db)]

Database session

required
id int

ID of the sharing group to remove the server

required
server_id Annotated[int, Path(alias=serverId)]

ID of the server to remove

required

Returns:

Type Description
dict

Representation of the removed server from the sharing group

remove_server_from_sharing_group_legacy async

remove_server_from_sharing_group_legacy(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))
    ],
    db: Annotated[Session, Depends(get_db)],
    id: Annotated[int, Path(alias=sharingGroupId)],
    server_id: Annotated[int, Path(alias=serverId)],
) -> StandardStatusResponse

Remove a server from a sharing group.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))]

Authenticated user with 'SHARING_GROUP' permission

required
db Annotated[Session, Depends(get_db)]

Database session

required
id Annotated[int, Path(alias=sharingGroupId)]

ID of the sharing group to remove the server from

required
server_id Annotated[int, Path(alias=serverId)]

ID of the server to remove

required

Returns:

Name Type Description
StandardStatusResponse StandardStatusResponse

Response indicating success or failure

update_sharing_group async

update_sharing_group(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))
    ],
    db: Annotated[Session, Depends(get_db)],
    id: int,
    body: UpdateSharingGroupBody,
) -> dict

Update an existing sharing group.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))]

Authentication details

required
db Annotated[Session, Depends(get_db)]

Database session

required
id int

ID of the sharing group to update

required
body UpdateSharingGroupBody

Request body containing updated details for the sharing group

required

Returns:

Type Description
dict

Representation of the updated sharing group

update_sharing_group_legacy async

update_sharing_group_legacy(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))
    ],
    db: Annotated[Session, Depends(get_db)],
    id: Annotated[int, Path(alias=sharingGroupId)],
    body: UpdateSharingGroupLegacyBody,
) -> ViewUpdateSharingGroupLegacyResponse

Update an existing sharing group by its ID.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))]

Authentication details

required
db Annotated[Session, Depends(get_db)]

Database session

required
id Annotated[int, Path(alias=sharingGroupId)]

ID of the sharing group to update

required
body UpdateSharingGroupLegacyBody

Request body containing updated details for the sharing group

required

Returns:

Name Type Description
ViewUpdateSharingGroupLegacyResponse ViewUpdateSharingGroupLegacyResponse

Representation of the updated sharing group.

view_sharing_group_legacy async

view_sharing_group_legacy(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))
    ],
    db: Annotated[Session, Depends(get_db)],
    id: Annotated[int | UUID, Path(alias=sharingGroupId)],
) -> SingleSharingGroupResponse

Retrieve details of a specific sharing group by its ID.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [SHARING_GROUP]))]

Authentication details

required
db Annotated[Session, Depends(get_db)]

Database session

required
id Annotated[int | UUID, Path(alias=sharingGroupId)]

ID of the sharing group to retrieve

required

Returns:

Type Description
SingleSharingGroupResponse

Representation of the sharing group details