GitLab Groups API

The Groups API from GitLab — 6 operation(s) for groups.

GitHub OpenAPI

Operations 42

0 of 42 operations are conformant: apis.io called them with no credentials and the responses matched this contract; 2 more answered but could not be checked against a schema. Checked 2026-11-12. how this works · status file

PUT /api/v4/groups/{id}/security_settings Update group security settings #
GET /api/v4/projects/{id}/share_locations List all groups available to invite to a project observed #
GET /api/v4/groups/{id}/billable_members List all billable group members #
POST /api/v4/groups/{id}/uploads/authorize Workhorse authorize the file upload #
POST /api/v4/groups/{id}/uploads Upload a file to a group #
GET /api/v4/groups/{id}/uploads List all uploads for a group #
GET /api/v4/groups/{id}/uploads/{upload_id} Download an uploaded file by ID #
DELETE /api/v4/groups/{id}/uploads/{upload_id} Delete an uploaded file by ID #
GET /api/v4/groups/{id}/uploads/{secret}/{filename} Download an uploaded file by secret and filename #
DELETE /api/v4/groups/{id}/uploads/{secret}/{filename} Delete an uploaded file by secret and filename #
GET /api/v4/groups/{id}/issues List all issues for a group #
GET /api/v4/groups/{id}/issues_statistics Retrieve issues statistics for a group #
GET /api/v4/groups/{id}/placeholder_reassignments Retrieve pending reassignments #
POST /api/v4/groups/{id}/placeholder_reassignments Reassign placeholders #
POST /api/v4/groups/{id}/placeholder_reassignments/authorize Workhorse authorization for the reassignment CSV file #
GET /api/v4/groups/{id}/runners List all runners in a group #
POST /api/v4/runners/reset_registration_token Reset the runner registration token for the instance #
POST /api/v4/groups/{id}/runners/reset_registration_token Reset the runner registration token for a group #
GET /api/v4/groups List all groups observed #
POST /api/v4/groups Create a group #
PUT /api/v4/groups/{id} Update group attributes #
GET /api/v4/groups/{id} Retrieve a group #
DELETE /api/v4/groups/{id} Schedule a group for deletion #
POST /api/v4/groups/{id}/archive Archive a group #
POST /api/v4/groups/{id}/unarchive Unarchive a group #
POST /api/v4/groups/{id}/restore Restore a group #
GET /api/v4/groups/{id}/groups/shared List all shared groups #
GET /api/v4/groups/{id}/invited_groups List all invited groups #
GET /api/v4/groups/{id}/projects List all projects in a group #
GET /api/v4/groups/{id}/projects/shared List all shared projects #
GET /api/v4/groups/{id}/subgroups List all subgroups #
GET /api/v4/groups/{id}/descendant_groups List all descendant groups #
POST /api/v4/groups/{id}/projects/{project_id} Transfer a project to a group #
GET /api/v4/groups/{id}/transfer_locations List all transfer locations for a group #
POST /api/v4/groups/{id}/transfer Transfer a group #
POST /api/v4/groups/{id}/transfer_to_organization Transfer a group to an organization #
POST /api/v4/groups/{id}/share Add a group to a group #
DELETE /api/v4/groups/{id}/share/{group_id} Remove a group from a group #
DELETE /api/v4/groups/{id}/shared_projects/{project_id} Remove a shared project from a group #
GET /api/v4/groups/{id}/audit_events/{audit_event_id} Retrieve a group audit event #
GET /api/v4/groups/{id}/saml_users List all SAML users #
GET /api/v4/groups/{id}/provisioned_users List all provisioned users #

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/gitlab:gitlab-groups-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

gitlab-groups-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: GitLab REST Groups API
  description: GitLab REST API used to interact with a GitLab installation.
  termsOfService: https://handbook.gitlab.com/handbook/legal/api-terms/
  version: '19.6'
  license:
    name: CC BY-SA 4.0
    url: https://gitlab.com/gitlab-org/gitlab/-/blob/master/LICENSE
    x-gitlab-description: The license applies to the OpenAPI specification document itself. For terms governing use of the GitLab API, see the termsOfService field.
servers:
- url: https://{hostname}
  description: GitLab REST API
  variables:
    hostname:
      default: gitlab.com
      description: Your GitLab instance hostname
security:
- http: []
- oauth2: []
- apiKey: []
tags:


# --- truncated at 32 KB (186 KB total) ---
# Full source: https://artifacts.apis.io/gitlab/openapi/gitlab-groups-api-openapi.yml