Package io.github.primelib.confluence4j.rest.v1.client

Class ConfluenceRestClientGroupConsumerApi

java.lang.Object
io.github.primelib.confluence4j.rest.v1.client.ConfluenceRestClientGroupConsumerApi
@Generated("io.github.primelib.primecodegen") public class ConfluenceRestClientGroupConsumerApi extends Object
ConfluenceRestClientGroupConsumerApi **[WARNING](https://support.atlassian.com/user-management/docs/create-and-update-groups/) The standard Atlassian group names are default names only and can be edited or deleted.** For example, an admin or Atlassian support could delete the default group jira-software-users or rename it to jsw-users at any point.

  • Constructor Details

  • Method Details

    • GetGroupV1

      public GroupArrayWithLinks GetGroupV1(Consumer<GetGroupV1OperationSpec> spec)
      GetGroupV1 Get groups Returns all user groups. The returned groups are ordered alphabetically in ascending order by group name. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission).
      Parameters:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • start: The starting index of the returned groups.
      • limit: The maximum number of groups to return per page. Note, this may be restricted by fixed system limits.
      • accessType: The group permission level for which to filter results.

    • PostGroupV1

      public Group PostGroupV1(Consumer<PostGroupV1OperationSpec> spec)
      PostGroupV1 Create new user group Creates a new user group. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: User must be a site admin.
      Parameters:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • payload: Name of the group that is to be created.

    • GetGroupByIDV1

      public Group GetGroupByIDV1(Consumer<GetGroupByIDV1OperationSpec> spec)
      GetGroupByIDV1 Get group Returns a user group for a given group id. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission).
      Parameters:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: The id of the group.

    • DeleteGroupByIDV1

      public void DeleteGroupByIDV1(Consumer<DeleteGroupByIDV1OperationSpec> spec)
      DeleteGroupByIDV1 Delete user group Delete user group. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: User must be a site admin.
      Parameters:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • id: Id of the group to delete.

    • GetGroupPickerV1

      public GroupArrayWithLinks GetGroupPickerV1(Consumer<GetGroupPickerV1OperationSpec> spec)
      GetGroupPickerV1 Search groups by partial query Get search results of groups by partial query provided.
      Parameters:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • query: the search term used to query results.
      • start: The starting index of the returned groups.
      • limit: The maximum number of groups to return per page. Note, this is restricted to a maximum limit of 200 groups.
      • shouldReturnTotalSize: Whether to include total size parameter in the results. Note, fetching total size property is an expensive operation; use it if your use case needs this value.

    • GetGroupByGroupIDMembersByGroupIDV1

      public UserArray GetGroupByGroupIDMembersByGroupIDV1(Consumer<GetGroupByGroupIDMembersByGroupIDV1OperationSpec> spec)
      GetGroupByGroupIDMembersByGroupIDV1 Get group members Returns the users that are members of a group. Use updated Get group API **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site ('Can use' global permission).
      Parameters:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • groupId: The id of the group to be queried for its members.
      • start: The starting index of the returned users.
      • limit: The maximum number of users to return per page. Note, this may be restricted by fixed system limits.
      • shouldReturnTotalSize: Whether to include total size parameter in the results. Note, fetching total size property is an expensive operation; use it if your use case needs this value.
      • expand: A multi-value parameter indicating which properties of the user to expand. - `operations` returns the operations that the user is allowed to do. - `personalSpace` returns the user's personal space, if it exists. - `isExternalCollaborator`(@deprecated) see `isGuest` in response to find out whether the user is a guest.

    • PostGroupUserByGroupIDV1

      public void PostGroupUserByGroupIDV1(Consumer<PostGroupUserByGroupIDV1OperationSpec> spec)
      PostGroupUserByGroupIDV1 Add member to group by groupId Adds a user as a member in a group represented by its groupId **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: User must be a site admin.
      Parameters:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • groupId: GroupId of the group whose membership is updated
      • payload: AccountId of the user who needs to be added as member.

    • DeleteGroupUserByGroupIDV1

      public void DeleteGroupUserByGroupIDV1(Consumer<DeleteGroupUserByGroupIDV1OperationSpec> spec)
      DeleteGroupUserByGroupIDV1 Remove member from group using group id Remove user as a member from a group. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: User must be a site admin.
      Parameters:
      spec - a consumer that creates the payload for this operation. Supports the following properties:
      • groupId: Id of the group whose membership is updated.
      • accountId: The account ID of the user. The accountId uniquely identifies the user across all Atlassian products. For example, `384093:32b4d9w0-f6a5-3535-11a3-9c8c88d10192`.
      • key: This parameter is no longer available and will be removed from the documentation soon. Use `accountId` instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.
      • username: This parameter is no longer available and will be removed from the documentation soon. Use `accountId` instead. See the [deprecation notice](/cloud/confluence/deprecation-notice-user-privacy-api-migration-guide/) for details.