GitLab CI/CD

GitLab CI/CD groups API

Operations about groups

GitHub OpenAPI

Operations 40

GET /api/v4/groups #
POST /api/v4/groups #
PUT /api/v4/groups/{id} #
GET /api/v4/groups/{id} #
DELETE /api/v4/groups/{id} #
POST /api/v4/groups/{id}/archive #
POST /api/v4/groups/{id}/unarchive #
POST /api/v4/groups/{id}/restore #
GET /api/v4/groups/{id}/groups/shared #
GET /api/v4/groups/{id}/invited_groups #
GET /api/v4/groups/{id}/projects #
GET /api/v4/groups/{id}/projects/shared #
GET /api/v4/groups/{id}/subgroups #
GET /api/v4/groups/{id}/descendant_groups #
POST /api/v4/groups/{id}/projects/{project_id} #
GET /api/v4/groups/{id}/transfer_locations #
POST /api/v4/groups/{id}/transfer #
POST /api/v4/groups/{id}/transfer_to_organization #
POST /api/v4/groups/{id}/share #
DELETE /api/v4/groups/{id}/share/{group_id} #
GET /api/v4/groups/{id}/audit_events/{audit_event_id} #
GET /api/v4/groups/{id}/saml_users #
GET /api/v4/groups/{id}/provisioned_users #
GET /api/v4/groups/{id}/runners List group's runners #
POST /api/v4/groups/{id}/runners/reset_registration_token Reset the runner registration token for a group #
GET /api/v4/groups/{id}/placeholder_reassignments Download the list of pending placeholder assignments for a group #
POST /api/v4/groups/{id}/placeholder_reassignments Upload placeholder reassignments CSV file #
POST /api/v4/groups/{id}/placeholder_reassignments/authorize Workhorse authorization for the reassignment CSV file #
GET /api/v4/groups/{id}/issues #
GET /api/v4/groups/{id}/issues_statistics #
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 #
GET /api/v4/groups/{id}/uploads/{upload_id} #
DELETE /api/v4/groups/{id}/uploads/{upload_id} #
GET /api/v4/groups/{id}/uploads/{secret}/{filename} #
DELETE /api/v4/groups/{id}/uploads/{secret}/{filename} #
GET /api/v4/groups/{id}/billable_members #
GET /api/v4/projects/{id}/share_locations #
POST /api/v4/runners/reset_registration_token Reset instance's runner registration token #

Documentation

📖
Documentation
https://docs.gitlab.com/api/
📖
APIReference
https://docs.gitlab.com/api/api_resources/
📖
Authentication
https://docs.gitlab.com/api/rest/authentication/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/gitlab-ci/refs/heads/main/openapi/gitlab-ci-groups-api-openapi.yml

Other Resources

🔗
OpenAPISource
https://docs.gitlab.com/api/openapi/openapi_v2.yaml
🔗
InteractiveDocs
https://docs.gitlab.com/api/openapi/openapi_interactive/

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-ci-groups-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

gitlab-ci-groups-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: GitLab access_requests Groups API
  version: v4
  description: Operations related to access requests
servers:
- url: https://gitlab.com
tags:
- name: groups
  description: Operations about groups
paths:
  /api/v4/groups:
    get:
      description: Get a groups list
      parameters:
      - in: query
        name: statistics
        description: Include project statistics
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: archived
        description: Limit by archived status
        required: false
        schema:
          type: boolean
      - in: query
        name: skip_groups
        description: Array of group ids to exclude from list
        required: false
        schema:
          type: array
          items:
            type: integer
            format: int32
      - in: query
        name: all_available
        description: When `true`, returns all accessible groups. When `false`, returns only groups where the user is a member.
        required: false
        schema:
          type: boolean
      - in: query
        name: visibility
        description: Limit by visibility
        required: false
        schema:
          type: string
          enum:
          - private
          - internal
          - public
      - in: query
        name: search
        description: Search for a specific group
        required: false
        schema:
          type: string
      - in: query
        name: owned
        description: Limit by owned by authenticated user
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: order_by
        description: Order by name, path, id or similarity if searching
        required: false
        schema:
          type: string
          enum:
          - name
          - path
          - id
          - similarity
          default: name
      - in: query
        name: sort
        description: Sort by asc (ascending) or desc (descending)
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: asc
      - in: query
        name: min_access_level
        description: Minimum access level of authenticated user
        required: false
        schema:
          type: integer
          format: int32
          enum:
          - 10
          - 15
          - 20
          - 30
          - 40
          - 50
      - in: query
        name: top_level_only
        description: Only include top-level groups
        required: false
        schema:
          type: boolean
      - in: query
        name: marked_for_deletion_on
        description: Return groups that are marked for deletion on this date
        required: false
        schema:
          type: string
          format: date
      - in: query
        name: active
        description: Limit by groups that are not archived and not marked for deletion
        required: false
        schema:
          type: boolean
      - in: query
        name: repository_storage
        description: Filter by repository storage used by the group
        required: false
        schema:
          type: string
      - in: query
        name: page
        description: Current page number
        required: false
        example: 1
        schema:
          type: integer
          format: int32
          default: 1
      - in: query
        name: per_page
        description: Number of items per page
        required: false
        example: 20
        schema:
          type: integer
          format: int32
          default: 20
      - in: query
        name: with_custom_attributes
        description: Include custom attributes in the response
        required: false
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: Get a groups list
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/API_Entities_Group'
      tags:
      - groups
      operationId: getApiV4Groups
    post:
      description: Create a group. Available only for users who can create groups.
      responses:
        '201':
          description: Create a group. Available only for users who can create groups.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/API_Entities_Group'
      tags:
      - groups
      operationId: postApiV4Groups
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/postApiV4Groups'
        required: true
  /api/v4/groups/{id}:
    put:
      description: Update a group. Available only for users who can administrate groups.
      parameters:
      - in: path
        name: id
        description: The ID of a group
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Update a group. Available only for users who can administrate groups.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/API_Entities_Group'
      tags:
      - groups
      operationId: putApiV4GroupsId
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/putApiV4GroupsId'
        required: true
    get:
      description: Get a single group, with containing projects.
      parameters:
      - in: path
        name: id
        description: The ID of a group
        required: true
        schema:
          type: string
      - in: query
        name: with_custom_attributes
        description: Include custom attributes in the response
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: with_projects
        description: Omit project details
        required: false
        schema:
          type: boolean
          default: true
      responses:
        '200':
          description: Get a single group, with containing projects.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/API_Entities_GroupDetail'
      tags:
      - groups
      operationId: getApiV4GroupsId
    delete:
      description: Remove a group.
      parameters:
      - in: path
        name: id
        description: The ID of a group
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Remove a group.
      tags:
      - groups
      operationId: deleteApiV4GroupsId
  /api/v4/groups/{id}/archive:
    post:
      description: Archive a group
      parameters:
      - in: path
        name: id
        description: The ID of a group
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Archive a group
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/API_Entities_Group'
        '403':
          description: Unauthenticated
      tags:
      - groups
      operationId: postApiV4GroupsIdArchive
  /api/v4/groups/{id}/unarchive:
    post:
      description: Unarchive a group
      parameters:
      - in: path
        name: id
        description: The ID of a group
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Unarchive a group
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/API_Entities_Group'
        '403':
          description: Unauthenticated
      tags:
      - groups
      operationId: postApiV4GroupsIdUnarchive
  /api/v4/groups/{id}/restore:
    post:
      description: Restore a group.
      parameters:
      - in: path
        name: id
        description: The ID of a group
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Restore a group.
      tags:
      - groups
      operationId: postApiV4GroupsIdRestore
  /api/v4/groups/{id}/groups/shared:
    get:
      description: Get a list of shared groups this group was invited to
      parameters:
      - in: path
        name: id
        description: The ID of a group
        required: true
        schema:
          type: string
      - in: query
        name: skip_groups
        description: Array of group ids to exclude from list
        required: false
        schema:
          type: array
          items:
            type: integer
            format: int32
      - in: query
        name: visibility
        description: Limit by visibility
        required: false
        schema:
          type: string
          enum:
          - private
          - internal
          - public
      - in: query
        name: search
        description: Search for a specific group
        required: false
        schema:
          type: string
      - in: query
        name: min_access_level
        description: Minimum access level of authenticated user
        required: false
        schema:
          type: integer
          format: int32
          enum:
          - 10
          - 15
          - 20
          - 30
          - 40
          - 50
      - in: query
        name: order_by
        description: Order by name, path, id or similarity if searching
        required: false
        schema:
          type: string
          enum:
          - name
          - path
          - id
          - similarity
          default: name
      - in: query
        name: sort
        description: Sort by asc (ascending) or desc (descending)
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: asc
      - in: query
        name: page
        description: Current page number
        required: false
        example: 1
        schema:
          type: integer
          format: int32
          default: 1
      - in: query
        name: per_page
        description: Number of items per page
        required: false
        example: 20
        schema:
          type: integer
          format: int32
          default: 20
      - in: query
        name: with_custom_attributes
        description: Include custom attributes in the response
        required: false
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: Get a list of shared groups this group was invited to
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/API_Entities_Group'
      tags:
      - groups
      operationId: getApiV4GroupsIdGroupsShared
  /api/v4/groups/{id}/invited_groups:
    get:
      description: Get a list of invited groups in this group
      parameters:
      - in: path
        name: id
        description: The ID of a group
        required: true
        schema:
          type: string
      - in: query
        name: relation
        description: Include group relations
        required: false
        schema:
          type: array
          items:
            type: string
            enum:
            - direct
            - inherited
      - in: query
        name: search
        description: Search for a specific group
        required: false
        schema:
          type: string
      - in: query
        name: min_access_level
        description: Minimum access level of authenticated user
        required: false
        schema:
          type: integer
          format: int32
          enum:
          - 10
          - 15
          - 20
          - 30
          - 40
          - 50
      - in: query
        name: page
        description: Current page number
        required: false
        example: 1
        schema:
          type: integer
          format: int32
          default: 1
      - in: query
        name: per_page
        description: Number of items per page
        required: false
        example: 20
        schema:
          type: integer
          format: int32
          default: 20
      - in: query
        name: with_custom_attributes
        description: Include custom attributes in the response
        required: false
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: Get a list of invited groups in this group
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/API_Entities_Group'
      tags:
      - groups
      operationId: getApiV4GroupsIdInvitedGroups
  /api/v4/groups/{id}/projects:
    get:
      description: Get a list of projects in this group.
      parameters:
      - in: path
        name: id
        description: The ID of a group
        required: true
        schema:
          type: string
      - in: query
        name: active
        description: Limit by projects that are not archived and not marked for deletion
        required: false
        schema:
          type: boolean
      - in: query
        name: archived
        description: Limit by archived status
        required: false
        schema:
          type: boolean
      - in: query
        name: visibility
        description: Limit by visibility
        required: false
        schema:
          type: string
          enum:
          - private
          - internal
          - public
      - in: query
        name: search
        description: Return list of authorized projects matching the search criteria
        required: false
        schema:
          type: string
      - in: query
        name: order_by
        description: Return projects ordered by field
        required: false
        schema:
          type: string
          enum:
          - id
          - name
          - path
          - created_at
          - updated_at
          - last_activity_at
          - similarity
          - star_count
          default: created_at
      - in: query
        name: sort
        description: Return projects sorted in ascending and descending order
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: desc
      - in: query
        name: simple
        description: Return only the ID, URL, name, and path of each project
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: owned
        description: Limit by owned by authenticated user
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: starred
        description: Limit by starred status
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: with_issues_enabled
        description: Limit by enabled issues feature
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: with_merge_requests_enabled
        description: Limit by enabled merge requests feature
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: with_shared
        description: Include projects shared to this group
        required: false
        schema:
          type: boolean
          default: true
      - in: query
        name: include_subgroups
        description: Includes projects in subgroups of this group
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: include_ancestor_groups
        description: Includes projects in ancestors of this group
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: min_access_level
        description: Limit by minimum access level of authenticated user on projects
        required: false
        schema:
          type: integer
          format: int32
          enum:
          - 10
          - 15
          - 20
          - 30
          - 40
          - 50
      - in: query
        name: page
        description: Current page number
        required: false
        example: 1
        schema:
          type: integer
          format: int32
          default: 1
      - in: query
        name: per_page
        description: Number of items per page
        required: false
        example: 20
        schema:
          type: integer
          format: int32
          default: 20
      - in: query
        name: with_custom_attributes
        description: Include custom attributes in the response
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: with_security_reports
        description: Return only projects having security report artifacts present
        required: false
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: Get a list of projects in this group.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/API_Entities_Project'
      tags:
      - groups
      operationId: getApiV4GroupsIdProjects
  /api/v4/groups/{id}/projects/shared:
    get:
      description: Get a list of shared projects in this group
      parameters:
      - in: path
        name: id
        description: The ID of a group
        required: true
        schema:
          type: string
      - in: query
        name: archived
        description: Limit by archived status
        required: false
        schema:
          type: boolean
      - in: query
        name: visibility
        description: Limit by visibility
        required: false
        schema:
          type: string
          enum:
          - private
          - internal
          - public
      - in: query
        name: search
        description: Return list of authorized projects matching the search criteria
        required: false
        schema:
          type: string
      - in: query
        name: order_by
        description: Return projects ordered by field
        required: false
        schema:
          type: string
          enum:
          - id
          - name
          - path
          - created_at
          - updated_at
          - last_activity_at
          - star_count
          default: created_at
      - in: query
        name: sort
        description: Return projects sorted in ascending and descending order
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: desc
      - in: query
        name: simple
        description: Return only the ID, URL, name, and path of each project
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: starred
        description: Limit by starred status
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: with_issues_enabled
        description: Limit by enabled issues feature
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: with_merge_requests_enabled
        description: Limit by enabled merge requests feature
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: min_access_level
        description: Limit by minimum access level of authenticated user on projects
        required: false
        schema:
          type: integer
          format: int32
          enum:
          - 10
          - 15
          - 20
          - 30
          - 40
          - 50
      - in: query
        name: page
        description: Current page number
        required: false
        example: 1
        schema:
          type: integer
          format: int32
          default: 1
      - in: query
        name: per_page
        description: Number of items per page
        required: false
        example: 20
        schema:
          type: integer
          format: int32
          default: 20
      - in: query
        name: with_custom_attributes
        description: Include custom attributes in the response
        required: false
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: Get a list of shared projects in this group
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/API_Entities_Project'
      tags:
      - groups
      operationId: getApiV4GroupsIdProjectsShared
  /api/v4/groups/{id}/subgroups:
    get:
      description: Get a list of subgroups in this group.
      parameters:
      - in: path
        name: id
        description: The ID of a group
        required: true
        schema:
          type: string
      - in: query
        name: statistics
        description: Include project statistics
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: archived
        description: Limit by archived status
        required: false
        schema:
          type: boolean
      - in: query
        name: skip_groups
        description: Array of group ids to exclude from list
        required: false
        schema:
          type: array
          items:
            type: integer
            format: int32
      - in: query
        name: all_available
        description: When `true`, returns all accessible groups. When `false`, returns only groups where the user is a member.
        required: false
        schema:
          type: boolean
      - in: query
        name: visibility
        description: Limit by visibility
        required: false
        schema:
          type: string
          enum:
          - private
          - internal
          - public
      - in: query
        name: search
        description: Search for a specific group
        required: false
        schema:
          type: string
      - in: query
        name: owned
        description: Limit by owned by authenticated user
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: order_by
        description: Order by name, path, id or similarity if searching
        required: false
        schema:
          type: string
          enum:
          - name
          - path
          - id
          - similarity
          default: name
      - in: query
        name: sort
        description: Sort by asc (ascending) or desc (descending)
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: asc
      - in: query
        name: min_access_level
        description: Minimum access level of authenticated user
        required: false
        schema:
          type: integer
          format: int32
          enum:
          - 10
          - 15
          - 20
          - 30
          - 40
          - 50
      - in: query
        name: top_level_only
        description: Only include top-level groups
        required: false
        schema:
          type: boolean
      - in: query
        name: marked_for_deletion_on
        description: Return groups that are marked for deletion on this date
        required: false
        schema:
          type: string
          format: date
      - in: query
        name: active
        description: Limit by groups that are not archived and not marked for deletion
        required: false
        schema:
          type: boolean
      - in: query
        name: repository_storage
        description: Filter by repository storage used by the group
        required: false
        schema:
          type: string
      - in: query
        name: page
        description: Current page number
        required: false
        example: 1
        schema:
          type: integer
          format: int32
          default: 1
      - in: query
        name: per_page
        description: Number of items per page
        required: false
        example: 20
        schema:
          type: integer
          format: int32
          default: 20
      - in: query
        name: with_custom_attributes
        description: Include custom attributes in the response
        required: false
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: Get a list of subgroups in this group.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/API_Entities_Group'
      tags:
      - groups
      operationId: getApiV4GroupsIdSubgroups
  /api/v4/groups/{id}/descendant_groups:
    get:
      description: Get a list of descendant groups of this group.
      parameters:
      - in: path
        name: id
        description: The ID of a group
        required: true
        schema:
          type: string
      - in: query
        name: statistics
        description: Include project statistics
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: archived
        description: Limit by archived status
        required: false
        schema:
          type: boolean
      - in: query
        name: skip_groups
        description: Array of group ids to exclude from list
        required: false
        schema:
          type: array
          items:
            type: integer
            format: int32
      - in: query
        name: all_available
        description: When `true`, returns all accessible groups. When `false`, returns only groups where the user is a member.
        required: false
        schema:
          type: boolean
      - in: query
        name: visibility
        description: Limit by visibility
        required: false
        schema:
          type: string
          enum:
          - private
          - internal
          - public
      - in: query
        name: search
        description: Search for a specific group
        required: false
        schema:
          type: string
      - in: query
        name: owned
        description: Limit by owned by authenticated user
        required: false
        schema:
          type: boolean
          default: false
      - in: query
        name: order_by
        description: Order by name, path, id or similarity if searching
        required: false
        schema:
          type: string
          enum:
          - name
          - path
          - id
          - similarity
          default: name
      - in: query
        name: sort
        description: Sort by asc (ascending) or desc (descending)
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: asc
      - in: query
        name: min_access_level
        description: Minimum access level of authenticated user
        required: false
        schema:
          type: integer
          format: int32
          enum:
          - 10
          - 15
          - 20
          - 30
          - 40
          - 50
      - in: query
        name: top_level_only
        description: Only include top-level groups
        required: false
        schema:
          type: boolean
      - in: query
        name: marked_for_deletion_on
        description: Return groups that are marked for deletion on this date
        required: false
        schema:
          type: string
          format: date
      - in: query
        name: active
        description: Limit by groups that are not archived and not marked for deletion
        required: false
        schema:
          type: boolean
      - in: query
        name: repository_storage
        description: Filter by repository storage used by the group
        required: false
        schema:
          type: string
      - in: query
        name: page
        description: Current page number
        required: false
        example: 1
        schema:
          type: integer
          format: int32
          default: 1
      - in: query
        name: per_page
        description: Number of items per page
        required: false
        example: 20
        schema:
          type: integer
          format: int32
          default: 20
      - in: query
        name: with_custom_attributes
        description: Include custom attributes in the response
        required: false
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: Get a list of descendant groups of this group.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/API_Entities_Group'
      tags:
      - groups
      operationId: getApiV4GroupsIdDescendantGroups
  /api/v4/groups/{id}/projects/{project_id}:
    post:
      description: Transfer a project to the group namespace. Available only for admin.
      parameters:
      - in: path
        name: id
        description: The ID of a group
        required: true
        schema:
          type: string
      - in: path
        name: project_id
        description: The ID or path of the project
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Transfer a project to the group namespace. Available only for admin.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/API_Entities_GroupDetail'
      tags:
      - groups
      operationId: postApiV4GroupsIdProjectsProjectId
  /api/v4/groups/{id}/transfer_locations:
    get:
      description: Get the groups to where the current group can be transferred to
      parameters:
      - in: path
        name: id
        description: The ID of a group
        required: true
        schema:
          type: string
      - in: query
        name: search
        description: Return list of namespaces matching the search criteria
        required: false
        schema:
          type: string
      - in: query
        name: page
        description: Current page number
        required: false
        example: 1
        schema:
          type: integer
          format: int32
          default: 1
      - in: query
        name: per_page
        description: Number of items per page
        required: false
        example: 20
        schema:
          type: integer
          format: int32
          default: 20
      responses:
        '200':
          description: Get the groups to where the current group can be transferred to
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/API_Entities_Group'
      tags:
      - groups
      operationId: getApiV4GroupsIdTransferLocations
  /api/v4/groups/{id}/transfer:
    post:
      description: Transfer a group to a new parent group or promote a subgroup to a top-level group
      parameters:
      - in: path
        name: id
        description: The ID of a group
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Transfer a group to a new parent group or promote a subgroup to a top-level group
      tags:
      - groups
      operationId: postApiV4GroupsIdTransfer
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/postApiV4GroupsIdTransfer'
        required: true
  /api/v4/groups/{id}/transfer_to_organization:
    post:
      description: Transfer a group to an organization
      parameters:
      - in: path
        name: id
        description: The ID of a group
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Transfer a group to an organ

# --- truncated at 32 KB (158 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/gitlab-ci/refs/heads/main/openapi/gitlab-ci-groups-api-openapi.yml