# Group API

Learn about the APIs for creating, retrieving, updating and deleting groups.

> For the index of this section of the site, see [llms.txt](https://fusionauth.io/docs/llms.txt)

A FusionAuth Group is a named object that optionally contains one to many Application Roles.

When a Group does not contain any Application Roles it can still be utilized to logically associate users. Assigning Application Roles to a group allow it to be used to dynamically manage Role assignment to registered Users. In this second scenario as long as a User is registered to an Application the Group membership will allow them to inherit the corresponding Roles from the Group.

The following APIs are provided to manage Groups and Group Membership.

| Operation | Method | Endpoint |
| --- | --- | --- |
| [Create a Group](https://fusionauth.io/docs/apis/groups/create-a-group.md) | `POST` | `/api/group`  
`/api/group/{groupId}` |
| [Retrieve a Group](https://fusionauth.io/docs/apis/groups/retrieve-a-group.md) | `GET` | `/api/group`  
`/api/group/{groupId}` |
| [Update a Group](https://fusionauth.io/docs/apis/groups/update-a-group.md) | `PUT` | `/api/group/{groupId}` |
| [Delete a Group](https://fusionauth.io/docs/apis/groups/delete-a-group.md) | `DELETE` | `/api/group/{groupId}` |
| [Search for Groups](https://fusionauth.io/docs/apis/groups/search-for-groups.md) | `GET`  
`POST` | `/api/group/search?name={name}&tenantId={tenantId}`  
`/api/group/search` |
| [Add Users to a Group](https://fusionauth.io/docs/apis/groups/add-users-to-a-group.md) | `POST` | `/api/group/member` |
| [Update Users in a Group](https://fusionauth.io/docs/apis/groups/update-users-in-a-group.md) | `PUT` | `/api/group/member` |
| [Remove Users from a Group](https://fusionauth.io/docs/apis/groups/remove-users-from-a-group.md) | `DELETE` | `/api/group/member/{memberId}`  
`/api/group/member?groupId={groupId}&userId={userId}`  
`/api/group/member?groupId={groupId}`  
`/api/group/member` |
| [Search for Group Members](https://fusionauth.io/docs/apis/groups/search-for-group-members.md) | `GET`  
`POST` | `/api/group/member/search?groupId={groupId}`  
`/api/group/member/search` |
---

## Other pages in Apis

> For the full index of this section, see [Apis](https://fusionauth.io/docs/llms-apis.txt).

- [User Action API](https://fusionauth.io/docs/apis/actioning-users.md): Learn about the APIs for invoking a User Action on a User.
- [API Keys API](https://fusionauth.io/docs/apis/api-keys.md): Learn about the APIs for creating, retrieving, updating and deleting API Keys.
- [Application API](https://fusionauth.io/docs/apis/applications.md): Learn about the APIs for creating, retrieving, updating and deleting Applications.
- [Audit Log API](https://fusionauth.io/docs/apis/audit-logs.md): Learn about the APIs for adding entries to, searching, and exporting the audit log.
- [Authenticate with our APIs](https://fusionauth.io/docs/apis/authentication.md): Learn how the FusionAuth APIs authenticate requests.
- [Configure CORS](https://fusionauth.io/docs/apis/configure-cors.md): How to set up and use the FusionAuth API Explorer.
- [Connector API](https://fusionauth.io/docs/apis/connectors.md): Learn about the APIs for creating, retrieving, updating and deleting identity providers.
- [Consent API](https://fusionauth.io/docs/apis/consents.md): Learn about the APIs for creating, retrieving, updating and deleting consents.
- [Custom Form API](https://fusionauth.io/docs/apis/custom-forms.md): Learn about the APIs for configuring custom forms.
- [Email API](https://fusionauth.io/docs/apis/emails.md): Learn about the APIs for creating, retrieving, updating and deleting email templates as well as sending emails to users.
- [Entity API](https://fusionauth.io/docs/apis/entities.md): Learn about the APIs for creating, retrieving, updating and deleting entities and entity types.
- [Error Responses](https://fusionauth.io/docs/apis/errors.md): Learn about the error response that is returned from FusionAuth APIs.
- [Event Log API](https://fusionauth.io/docs/apis/event-logs.md): Learn about the APIs for searching and retrieving event logs.
- [Family API](https://fusionauth.io/docs/apis/families.md): Learn about the APIs for creating, retrieving, updating and deleting families.
- [Hosted Backend API](https://fusionauth.io/docs/apis/hosted-backend.md): Learn about the APIs that you to perform OAuth2 Authorization Code Flow login, logout, and refresh for applications.
- [Identity Provider API](https://fusionauth.io/docs/apis/identity-providers.md): Learn about the APIs for creating, retrieving, updating and deleting identity providers.
- [Identity Verify API](https://fusionauth.io/docs/apis/identity-verify.md): Learn about the APIs for starting, sending, and completing identity verification.
- [Integration API](https://fusionauth.io/docs/apis/integrations.md): Learn about the APIs for retrieving and updating integrations.
- [IP Access Control List API](https://fusionauth.io/docs/apis/ip-acl.md): Learn about the APIs for creating, retrieving, updating and deleting IP Access Control Lists.
- [JWTs & Refresh Token API](https://fusionauth.io/docs/apis/jwt.md): Learn about the APIs that allow you to manage Refresh Tokens, verify Access Tokens and retrieve public keys used for verifying JWT signatures.
- [Key API](https://fusionauth.io/docs/apis/keys.md): Learn about the APIs for generating, importing, retrieving, updating and deleting keys.
- [Lambda API](https://fusionauth.io/docs/apis/lambdas.md): Learn about the APIs for creating, retrieving, updating and deleting lambdas.
- [Login API](https://fusionauth.io/docs/apis/login.md): API documentation for the FusionAuth Login API.
- [Message Template API](https://fusionauth.io/docs/apis/message-templates.md): Learn about the APIs for creating, retrieving, updating and deleting message templates.
- [Messenger API](https://fusionauth.io/docs/apis/messengers.md): Learn about the APIs for creating, retrieving, updating and deleting messengers.
- [OAuth2 API](https://fusionauth.io/docs/apis/oauth.md): This page details FusionAuth's OAuth2 endpoints. Learn about the Authorization Code grant, `Implicit` grant, and other OAuth2 grants.
- [Passwordless API](https://fusionauth.io/docs/apis/passwordless.md): Learn about the APIs for magic link passwordless authentication.
- [Reactor API](https://fusionauth.io/docs/apis/reactor.md): Learn about the APIs for activating, deactivating, and retrieving the status of a FusionAuth Reactor license.
- [User Registration API](https://fusionauth.io/docs/apis/registrations.md): Learn about the APIs for creating, retrieving, updating and deleting User Registrations.
- [Report API](https://fusionauth.io/docs/apis/reports.md): Learn about the APIs for retrieving reports from FusionAuth.
- [SCIM API](https://fusionauth.io/docs/apis/scim.md): Learn about the APIs for provisioning SCIM Resources in FusionAuth using a SCIM Client.
- [OAuth Scopes API](https://fusionauth.io/docs/apis/scopes.md): Learn about the APIs for creating, retrieving, updating and deleting OAuth scopes.
- [System API](https://fusionauth.io/docs/apis/system.md): Learn about the APIs for retrieving and updating the system configuration.
- [Tenant Manager API](https://fusionauth.io/docs/apis/tenant-manager.md): Learn about the APIs for retrieving and updating Tenant Manager configuration.
- [Tenants API](https://fusionauth.io/docs/apis/tenants.md): Learn about the APIs for creating, retrieving, updating and deleting tenants.
- [Theme API](https://fusionauth.io/docs/apis/themes.md): Learn about the APIs for customizing a theme.
- [Multi-Factor API](https://fusionauth.io/docs/apis/two-factor.md): Learn about the APIs for enabling and disabling multi-factor authentication for users.
- [User Action Reason API](https://fusionauth.io/docs/apis/user-action-reasons.md): Learn about the APIs for creating, retrieving, updating and deleting user action reasons.
- [Manage User Action API](https://fusionauth.io/docs/apis/user-actions.md): Learn about the APIs for creating, retrieving, updating and deleting user actions.
- [User Comment API](https://fusionauth.io/docs/apis/user-comments.md): Learn about the APIs for creating and retrieving comments on users.
- [User API](https://fusionauth.io/docs/apis/users.md): Learn how to integrate with the FusionAuth User API. This documentation provides a comprehensive reference for managing users.
- [WebAuthn API](https://fusionauth.io/docs/apis/webauthn.md): Learn about the APIs for starting and completing WebAuthn ceremonies and retrieving, importing and deleting WebAuthn passkeys.
- [Webhook Event Log API](https://fusionauth.io/docs/apis/webhook-event-logs.md): Learn about the APIs for searching and retrieving webhook event and attempt logs.
- [Webhook API](https://fusionauth.io/docs/apis/webhooks.md): Learn about the APIs for creating, retrieving, updating and deleting Webhooks.
