# GitLab Members API

**Canonical:** https://apis.io/apis/gitlab/gitlab-members-api/  
**Provider:** GitLab — https://apis.io/providers/gitlab/  
**Base URL:** https://gitlab.com/api/v4  
**Documentation:** https://docs.gitlab.com/api/rest/

GitLab Members API is one of 189 APIs that [GitLab](https://apis.io/providers/gitlab/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. This API exposes 16 JSON Schema definitions. Tagged areas include Members. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, an API reference, rate-limit docs, an AsyncAPI specification, and 16 JSON Schemas.

Use this API to manage the [members](https://docs.gitlab.com/user/project/members/) of a group or a project, including inherited memberships, membership approvals, and the billable members of a group.

## Operations (23)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v4/groups/{id}/members` | List all direct members of a group |
| POST | `/api/v4/groups/{id}/members` | Add a member to a group |
| GET | `/api/v4/groups/{id}/members/all` | List all members of a group |
| GET | `/api/v4/groups/{id}/members/{user_id}` | Retrieve a direct group member |
| PUT | `/api/v4/groups/{id}/members/{user_id}` | Update a group member |
| DELETE | `/api/v4/groups/{id}/members/{user_id}` | Remove a member from a group |
| GET | `/api/v4/groups/{id}/members/all/{user_id}` | Retrieve a group member |
| GET | `/api/v4/projects/{id}/members` | List all direct members of a project |
| POST | `/api/v4/projects/{id}/members` | Add a member to a project |
| GET | `/api/v4/projects/{id}/members/all` | List all members of a project |
| GET | `/api/v4/projects/{id}/members/{user_id}` | Retrieve a direct project member |
| PUT | `/api/v4/projects/{id}/members/{user_id}` | Update a project member |
| DELETE | `/api/v4/projects/{id}/members/{user_id}` | Remove a member from a project |
| GET | `/api/v4/projects/{id}/members/all/{user_id}` | Retrieve a project member |
| POST | `/api/v4/groups/{id}/members/{user_id}/override` | Set override flag for a member of a group |
| DELETE | `/api/v4/groups/{id}/members/{user_id}/override` | Remove an LDAP access level override |
| PUT | `/api/v4/groups/{id}/members/{member_id}/approve` | Approve a group member |
| POST | `/api/v4/groups/{id}/members/approve_all` | Approve all pending group members |
| GET | `/api/v4/groups/{id}/pending_members` | List all pending group members |
| PUT | `/api/v4/groups/{id}/members/{user_id}/state` | Update group membership state for a user |
| GET | `/api/v4/groups/{id}/billable_members/{user_id}/memberships` | List all memberships for a billable group member |
| GET | `/api/v4/groups/{id}/billable_members/{user_id}/indirect` | List all indirect memberships for a billable group member |
| DELETE | `/api/v4/groups/{id}/billable_members/{user_id}` | Remove a billable member from a group |

## Machine-readable artifacts (65)

- **OpenAPI** — https://artifacts.apis.io/gitlab/openapi/gitlab-members-api-openapi.yml
- **Documentation** — https://docs.gitlab.com/api/openapi/
- **Documentation** — https://docs.gitlab.com/api/issues/
- **Authentication** — https://docs.gitlab.com/api/rest/authentication/
- **JSONSchema** — https://artifacts.apis.io/gitlab/json-schema/gitlab-put-api-v4-application-settings-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/gitlab/json-schema/gitlab-apientities-geo-node-status-schema.json
- **JSONSchema** — https://artifacts.apis.io/gitlab/json-schema/gitlab-apientities-geo-site-status-schema.json
- **JSONSchema** — https://artifacts.apis.io/gitlab/json-schema/gitlab-apientities-application-setting-schema.json
- **JSONSchema** — https://artifacts.apis.io/gitlab/json-schema/gitlab-post-api-v4-geo-status-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/gitlab/json-schema/gitlab-put-api-v4-projects-id-request-schema.json
- **Documentation** — https://docs.gitlab.com/api/merge_requests/
- **Documentation** — https://docs.gitlab.com/api/pipelines/
- **Documentation** — https://docs.gitlab.com/api/jobs/
- **Documentation** — https://docs.gitlab.com/api/runners/
- **Documentation** — https://docs.gitlab.com/api/users/
- **Documentation** — https://docs.gitlab.com/api/repositories/
- **Documentation** — https://docs.gitlab.com/api/commits/
- **Documentation** — https://docs.gitlab.com/api/branches/
- **Documentation** — https://docs.gitlab.com/api/tags/
- **Documentation** — https://docs.gitlab.com/api/releases/
- **Documentation** — https://docs.gitlab.com/api/environments/
- **Documentation** — https://docs.gitlab.com/api/deployments/
- **Documentation** — https://docs.gitlab.com/api/pipeline_schedules/
- **Documentation** — https://docs.gitlab.com/api/labels/
- **Documentation** — https://docs.gitlab.com/api/milestones/
- **Documentation** — https://docs.gitlab.com/api/notes/
- **Documentation** — https://docs.gitlab.com/api/snippets/
- **Documentation** — https://docs.gitlab.com/api/packages/
- **Documentation** — https://docs.gitlab.com/api/container_registry/
- **Documentation** — https://docs.gitlab.com/api/vulnerabilities/
- **Documentation** — https://docs.gitlab.com/api/deploy_keys/
- **Documentation** — https://docs.gitlab.com/api/protected_branches/
- **Documentation** — https://docs.gitlab.com/api/wikis/
- **Documentation** — https://docs.gitlab.com/api/events/
- **Documentation** — https://docs.gitlab.com/api/search/
- **Documentation** — https://docs.gitlab.com/api/namespaces/
- **Documentation** — https://docs.gitlab.com/api/groups/
- **Documentation** — https://docs.gitlab.com/api/projects/
- **Documentation** — https://docs.gitlab.com/api/applications/
- **Documentation** — https://docs.gitlab.com/api/avatar/
- …and 25 more, listed in full on the page.

## Other GitLab APIs (12)

- [GitLab Orbit gRPC API](https://apis.io/apis/gitlab/gitlab-orbit-api/)
- [GitLab GraphQL API](https://apis.io/apis/gitlab/gitlab-graphql-api/)
- [GitLab Applications API](https://apis.io/apis/gitlab/gitlab-applications-api/)
- [GitLab Authorization API](https://apis.io/apis/gitlab/gitlab-authorization-api/)
- [GitLab Broadcast Messages API](https://apis.io/apis/gitlab/gitlab-broadcast-messages-api/)
- [GitLab Groups API](https://apis.io/apis/gitlab/gitlab-groups-api/)
- [GitLab Metadata API](https://apis.io/apis/gitlab/gitlab-metadata-api/)
- [GitLab Project Webhooks API](https://apis.io/apis/gitlab/gitlab-project-webhooks-api/)
- [GitLab Projects API](https://apis.io/apis/gitlab/gitlab-projects-api/)
- [GitLab Tokens API](https://apis.io/apis/gitlab/gitlab-tokens-api/)
- [GitLab User Info API](https://apis.io/apis/gitlab/gitlab-user-info-api/)
- [GitLab Webhook Configuration API](https://apis.io/apis/gitlab/gitlab-webhook-configuration-api/)

## Tags

Members

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/gitlab/gitlab-members-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/gitlab/.