Maven virtual registry API

  • Tier: Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
  • Status: Beta

The availability of these endpoints is controlled by a feature flag. For more information, see the history.

Use this API to:

  • Create and manage Maven virtual registries.
  • Configure upstream registries.
  • Manage cache entries.
  • Handle package downloads and uploads.

Manage Maven virtual registries

Use the following endpoints to create and manage Maven virtual registries.

List all virtual registries

Lists all Maven virtual registries for a specified group.

GET /groups/:id/-/virtual_registries/packages/maven/registries

Supported attributes:

AttributeTypeRequiredDescription
idstring/integeryesThe group ID or full group path. Must be a top-level group.

Example request:

shell
curl --request GET \
     --header "PRIVATE-TOKEN: <your_access_token>" \
     --header "Accept: application/json" \
     --url "https://gitlab.example.com/api/v4/groups/5/-/virtual_registries/packages/maven/registries"

Example response:

json
[
  {
    "id": 1