Packages: Conan

The Conan registry is not FIPS compliant and is disabled when FIPS mode is enabled. These endpoints all return 404 Not Found.

Use this API to interact with the Conan package manager for v1 and v2 repositories. The v1 endpoints work for both projects and instances, and the availability of the v2 endpoints is controlled by a feature flag. Generally these endpoints are used by the Conan package manager client and are not meant for manual consumption.

These endpoints do not adhere to the standard API authentication methods. See each route for details on how credentials are expected to be passed. Undocumented authentication methods might be removed in the future.

Search for a Conan package

GET /api/v4/packages/conan/v1/conans/search

Searches the instance for a specified Conan package.

Parameters

Name	Type	Description
`q` Query, required	String	Search query. Use `` as a wildcard Example: `Hello`
`ignorecase` Query	Boolean	If `true`, ignores case when searching Example: `false`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`404`	Not Found	—

Retrieve a recipe snapshot

GET /api/v4/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}

Retrieves a snapshot of the files for a specified Conan recipe. The snapshot is a list of filenames with their associated MD5 hash.

Parameters

Name	Type	Description
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanRecipeSnapshot
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

Delete a recipe and package

DELETE /api/v4/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}

Deletes a specified Conan recipe and associated package files from the package registry.

Parameters

Name	Type	Description
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve a recipe manifest

GET /api/v4/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}/digest

Retrieves a manifest that includes a list of files and associated download URLs for a specified recipe.

Parameters

Name	Type	Description
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanRecipeManifest
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

List all recipe download URLs

GET /api/v4/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}/download_urls

Lists all files and associated download URLs for a specified recipe in the package registry. Returns the same payload as the recipe manifest endpoint.

Parameters

Name	Type	Description
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanRecipeManifest
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve a package snapshot

GET /api/v4/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}/packages/{conan_package_reference}

Retrieves a snapshot of the files for a specified Conan package and reference. The snapshot is a list of filenames with their associated MD5 hash.

Parameters

Name	Type	Description
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `103f6067a947f366ef91fc1b7da351c588d1827f`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanPackageSnapshot
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve a package manifest

GET /api/v4/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}/packages/{conan_package_reference}/digest

Retrieves a manifest that includes a list of files and associated download URLs for a specified package.

Parameters

Name	Type	Description
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `103f6067a947f366ef91fc1b7da351c588d1827f`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanPackageManifest
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

List all package download URLs

GET /api/v4/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}/packages/{conan_package_reference}/download_urls

Lists all files and associated download URLs for a specified package in the package registry. Returns the same payload as the package manifest endpoint.

Parameters

Name	Type	Description
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `103f6067a947f366ef91fc1b7da351c588d1827f`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanPackageManifest
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

List all package upload URLs

POST /api/v4/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}/packages/{conan_package_reference}/upload_urls

Lists all the upload URLs for a specified collection of package files. The request must include a JSON object with the name and size of the individual files.

Parameters

Name	Type	Description
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `103f6067a947f366ef91fc1b7da351c588d1827f`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanUploadUrls
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve package references metadata

GET /api/v4/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}/search

Retrieves the metadata for all package references of a specified package. This feature was introduced in GitLab 18.0.

Parameters

Name	Type	Description
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

List all recipe upload URLs

POST /api/v4/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}/upload_urls

Lists all the upload URLs for a specified collection of recipe files. The request must include a JSON object with the name and size of the individual files.

Parameters

Name	Type	Description
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanUploadUrls
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve a recipe file

GET /api/v4/packages/conan/v1/files/{package_name}/{package_version}/{package_username}/{package_channel}/{recipe_revision}/export/{file_name}

Retrieves a specified recipe file from the package registry. You must use the download URL returned from the recipe download URLs endpoint.

Parameters

Name	Type	Description
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe. GitLab does not yet support Conan revisions, so the default value of `0` is always used Example: `0`
`file_name` Path, required	String	Name of the package file Allowed values: `conanfile.py`, `conanmanifest.txt`, `conan_sources.tgz`, `conan_export.tgz`, `conaninfo.txt`, `conan_package.tgz` Minimum length: `1` Example: `conanfile.py`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

Upload a recipe file

PUT /api/v4/packages/conan/v1/files/{package_name}/{package_version}/{package_username}/{package_channel}/{recipe_revision}/export/{file_name}

Uploads a specified recipe file to the package registry. You must use the upload URL returned from the recipe upload URLs endpoint.

Parameters

Name	Type	Description
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe. GitLab does not yet support Conan revisions, so the default value of `0` is always used Example: `0`
`file_name` Path, required	String	Name of the package file Allowed values: `conanfile.py`, `conanmanifest.txt`, `conan_sources.tgz`, `conan_export.tgz`, `conaninfo.txt`, `conan_package.tgz` Minimum length: `1` Example: `conanfile.py`

Request body (multipart/form-data)

Property	Type	Description
`file` Required	String (binary)	The package file to be published (generated by Multipart middleware)

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Workhorse authorize the Conan recipe file

PUT /api/v4/packages/conan/v1/files/{package_name}/{package_version}/{package_username}/{package_channel}/{recipe_revision}/export/{file_name}/authorize

Authorizes the Conan recipe file.

Parameters

Name	Type	Description
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe. GitLab does not yet support Conan revisions, so the default value of `0` is always used Example: `0`
`file_name` Path, required	String	Name of the package file Allowed values: `conanfile.py`, `conanmanifest.txt`, `conan_sources.tgz`, `conan_export.tgz`, `conaninfo.txt`, `conan_package.tgz` Minimum length: `1` Example: `conanfile.py`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve a package file

GET /api/v4/packages/conan/v1/files/{package_name}/{package_version}/{package_username}/{package_channel}/{recipe_revision}/package/{conan_package_reference}/{package_revision}/{file_name}

Retrieves a specified package file from the package registry. You must use the download URL returned from the package download URLs endpoint.

Parameters

Name	Type	Description
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe. GitLab does not yet support Conan revisions, so the default value of `0` is always used Example: `0`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `103f6067a947f366ef91fc1b7da351c588d1827f`
`package_revision` Path, required	String	Revision of the package. GitLab does not yet support Conan revisions, so the default value of `0` is always used Example: `0`
`file_name` Path, required	String	Name of the package file Allowed values: `conanfile.py`, `conanmanifest.txt`, `conan_sources.tgz`, `conan_export.tgz`, `conaninfo.txt`, `conan_package.tgz` Minimum length: `1` Example: `conaninfo.txt`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

Upload a package file

PUT /api/v4/packages/conan/v1/files/{package_name}/{package_version}/{package_username}/{package_channel}/{recipe_revision}/package/{conan_package_reference}/{package_revision}/{file_name}

Uploads a specified package file to the package registry. You must use the upload URL returned from the package upload URLs endpoint.

Parameters

Name	Type	Description
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe. GitLab does not yet support Conan revisions, so the default value of `0` is always used Example: `0`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `103f6067a947f366ef91fc1b7da351c588d1827f`
`package_revision` Path, required	String	Revision of the package. GitLab does not yet support Conan revisions, so the default value of `0` is always used Example: `0`
`file_name` Path, required	String	Name of the package file Allowed values: `conanfile.py`, `conanmanifest.txt`, `conan_sources.tgz`, `conan_export.tgz`, `conaninfo.txt`, `conan_package.tgz` Minimum length: `1` Example: `conaninfo.txt`

Request body (multipart/form-data)

Property	Type	Description
`file` Required	String (binary)	The package file to be published (generated by Multipart middleware)

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Workhorse authorize the Conan package file

PUT /api/v4/packages/conan/v1/files/{package_name}/{package_version}/{package_username}/{package_channel}/{recipe_revision}/package/{conan_package_reference}/{package_revision}/{file_name}/authorize

Authorizes the Conan package file.

Parameters

Name	Type	Description
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe. GitLab does not yet support Conan revisions, so the default value of `0` is always used Example: `0`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `103f6067a947f366ef91fc1b7da351c588d1827f`
`package_revision` Path, required	String	Revision of the package. GitLab does not yet support Conan revisions, so the default value of `0` is always used Example: `0`
`file_name` Path, required	String	Name of the package file Allowed values: `conanfile.py`, `conanmanifest.txt`, `conan_sources.tgz`, `conan_export.tgz`, `conaninfo.txt`, `conan_package.tgz` Minimum length: `1` Example: `conaninfo.txt`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Verify availability of a Conan repository

GET /api/v4/packages/conan/v1/ping

Verifies availability of a Conan repository.

Responses

Code	Description	Schema
`200`	OK	—
`404`	Not Found	—

Retrieve an authentication token

GET /api/v4/packages/conan/v1/users/authenticate

Retrieves an authentication token. Creates a JSON Web Token (JWT) for use as a Bearer header in other requests to the package registry.

Responses

Code	Description	Schema
`200`	OK	—
`401`	Unauthorized	—
`404`	Not Found	—

Verify authentication credentials

GET /api/v4/packages/conan/v1/users/check_credentials

Verifies authentication credentials for a Conan package registry.

Responses

Code	Description	Schema
`200`	OK	—
`401`	Unauthorized	—
`404`	Not Found	—

Search for a Conan package

GET /api/v4/projects/{id}/packages/conan/v1/conans/search

Searches the instance for a specified Conan package.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`q` Query, required	String	Search query. Use `` as a wildcard Example: `Hello`
`ignorecase` Query	Boolean	If `true`, ignores case when searching Example: `false`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`404`	Not Found	—

Retrieve a recipe snapshot

GET /api/v4/projects/{id}/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}

Retrieves a snapshot of the files for a specified Conan recipe. The snapshot is a list of filenames with their associated MD5 hash.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanRecipeSnapshot
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

Delete a recipe and package

DELETE /api/v4/projects/{id}/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}

Deletes a specified Conan recipe and associated package files from the package registry.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve a recipe manifest

GET /api/v4/projects/{id}/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}/digest

Retrieves a manifest that includes a list of files and associated download URLs for a specified recipe.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanRecipeManifest
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

List all recipe download URLs

GET /api/v4/projects/{id}/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}/download_urls

Lists all files and associated download URLs for a specified recipe in the package registry. Returns the same payload as the recipe manifest endpoint.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanRecipeManifest
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve a package snapshot

GET /api/v4/projects/{id}/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}/packages/{conan_package_reference}

Retrieves a snapshot of the files for a specified Conan package and reference. The snapshot is a list of filenames with their associated MD5 hash.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `103f6067a947f366ef91fc1b7da351c588d1827f`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanPackageSnapshot
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve a package manifest

GET /api/v4/projects/{id}/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}/packages/{conan_package_reference}/digest

Retrieves a manifest that includes a list of files and associated download URLs for a specified package.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `103f6067a947f366ef91fc1b7da351c588d1827f`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanPackageManifest
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

List all package download URLs

GET /api/v4/projects/{id}/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}/packages/{conan_package_reference}/download_urls

Lists all files and associated download URLs for a specified package in the package registry. Returns the same payload as the package manifest endpoint.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `103f6067a947f366ef91fc1b7da351c588d1827f`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanPackageManifest
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

List all package upload URLs

POST /api/v4/projects/{id}/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}/packages/{conan_package_reference}/upload_urls

Lists all the upload URLs for a specified collection of package files. The request must include a JSON object with the name and size of the individual files.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `103f6067a947f366ef91fc1b7da351c588d1827f`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanUploadUrls
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve package references metadata

GET /api/v4/projects/{id}/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}/search

Retrieves the metadata for all package references of a specified package. This feature was introduced in GitLab 18.0.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

List all recipe upload URLs

POST /api/v4/projects/{id}/packages/conan/v1/conans/{package_name}/{package_version}/{package_username}/{package_channel}/upload_urls

Lists all the upload URLs for a specified collection of recipe files. The request must include a JSON object with the name and size of the individual files.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanUploadUrls
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve a recipe file

GET /api/v4/projects/{id}/packages/conan/v1/files/{package_name}/{package_version}/{package_username}/{package_channel}/{recipe_revision}/export/{file_name}

Retrieves a specified recipe file from the package registry. You must use the download URL returned from the recipe download URLs endpoint.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe. GitLab does not yet support Conan revisions, so the default value of `0` is always used Example: `0`
`file_name` Path, required	String	Name of the package file Allowed values: `conanfile.py`, `conanmanifest.txt`, `conan_sources.tgz`, `conan_export.tgz`, `conaninfo.txt`, `conan_package.tgz` Minimum length: `1` Example: `conanfile.py`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

Upload a recipe file

PUT /api/v4/projects/{id}/packages/conan/v1/files/{package_name}/{package_version}/{package_username}/{package_channel}/{recipe_revision}/export/{file_name}

Uploads a specified recipe file to the package registry. You must use the upload URL returned from the recipe upload URLs endpoint.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe. GitLab does not yet support Conan revisions, so the default value of `0` is always used Example: `0`
`file_name` Path, required	String	Name of the package file Allowed values: `conanfile.py`, `conanmanifest.txt`, `conan_sources.tgz`, `conan_export.tgz`, `conaninfo.txt`, `conan_package.tgz` Minimum length: `1` Example: `conanfile.py`

Request body (multipart/form-data)

Property	Type	Description
`file` Required	String (binary)	The package file to be published (generated by Multipart middleware)

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Workhorse authorize the Conan recipe file

PUT /api/v4/projects/{id}/packages/conan/v1/files/{package_name}/{package_version}/{package_username}/{package_channel}/{recipe_revision}/export/{file_name}/authorize

Authorizes the Conan recipe file.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe. GitLab does not yet support Conan revisions, so the default value of `0` is always used Example: `0`
`file_name` Path, required	String	Name of the package file Allowed values: `conanfile.py`, `conanmanifest.txt`, `conan_sources.tgz`, `conan_export.tgz`, `conaninfo.txt`, `conan_package.tgz` Minimum length: `1` Example: `conanfile.py`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve a package file

GET /api/v4/projects/{id}/packages/conan/v1/files/{package_name}/{package_version}/{package_username}/{package_channel}/{recipe_revision}/package/{conan_package_reference}/{package_revision}/{file_name}

Retrieves a specified package file from the package registry. You must use the download URL returned from the package download URLs endpoint.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe. GitLab does not yet support Conan revisions, so the default value of `0` is always used Example: `0`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `103f6067a947f366ef91fc1b7da351c588d1827f`
`package_revision` Path, required	String	Revision of the package. GitLab does not yet support Conan revisions, so the default value of `0` is always used Example: `0`
`file_name` Path, required	String	Name of the package file Allowed values: `conanfile.py`, `conanmanifest.txt`, `conan_sources.tgz`, `conan_export.tgz`, `conaninfo.txt`, `conan_package.tgz` Minimum length: `1` Example: `conaninfo.txt`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`403`	Forbidden	—
`404`	Not Found	—

Upload a package file

PUT /api/v4/projects/{id}/packages/conan/v1/files/{package_name}/{package_version}/{package_username}/{package_channel}/{recipe_revision}/package/{conan_package_reference}/{package_revision}/{file_name}

Uploads a specified package file to the package registry. You must use the upload URL returned from the package upload URLs endpoint.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe. GitLab does not yet support Conan revisions, so the default value of `0` is always used Example: `0`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `103f6067a947f366ef91fc1b7da351c588d1827f`
`package_revision` Path, required	String	Revision of the package. GitLab does not yet support Conan revisions, so the default value of `0` is always used Example: `0`
`file_name` Path, required	String	Name of the package file Allowed values: `conanfile.py`, `conanmanifest.txt`, `conan_sources.tgz`, `conan_export.tgz`, `conaninfo.txt`, `conan_package.tgz` Minimum length: `1` Example: `conaninfo.txt`

Request body (multipart/form-data)

Property	Type	Description
`file` Required	String (binary)	The package file to be published (generated by Multipart middleware)

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Workhorse authorize the Conan package file

Authorizes the Conan package file.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe. GitLab does not yet support Conan revisions, so the default value of `0` is always used Example: `0`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `103f6067a947f366ef91fc1b7da351c588d1827f`
`package_revision` Path, required	String	Revision of the package. GitLab does not yet support Conan revisions, so the default value of `0` is always used Example: `0`
`file_name` Path, required	String	Name of the package file Allowed values: `conanfile.py`, `conanmanifest.txt`, `conan_sources.tgz`, `conan_export.tgz`, `conaninfo.txt`, `conan_package.tgz` Minimum length: `1` Example: `conaninfo.txt`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Verify availability of a Conan repository

GET /api/v4/projects/{id}/packages/conan/v1/ping

Verifies availability of a Conan repository.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`404`	Not Found	—

Retrieve an authentication token

GET /api/v4/projects/{id}/packages/conan/v1/users/authenticate

Retrieves an authentication token. Creates a JSON Web Token (JWT) for use as a Bearer header in other requests to the package registry.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`404`	Not Found	—

Verify authentication credentials

GET /api/v4/projects/{id}/packages/conan/v1/users/check_credentials

Verifies authentication credentials for a Conan package registry.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`404`	Not Found	—

Search for a Conan package

GET /api/v4/projects/{id}/packages/conan/v2/conans/search

Searches the instance for a specified Conan package.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`q` Query, required	String	Search query. Use `` as a wildcard Example: `Hello`
`ignorecase` Query	Boolean	If `true`, ignores case when searching Example: `false`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`404`	Not Found	—

Retrieve latest recipe revision

GET /api/v4/projects/{id}/packages/conan/v2/conans/{package_name}/{package_version}/{package_username}/{package_channel}/latest

Retrieves the revision hash and creation date of the latest package recipe. This feature was introduced in GitLab 17.11.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanRevision
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

List all recipe revisions

GET /api/v4/projects/{id}/packages/conan/v2/conans/{package_name}/{package_version}/{package_username}/{package_channel}/revisions

Lists all revisions for a package recipe. This feature was introduced in GitLab 17.11.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanRecipeRevisions
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Delete recipe revision

DELETE /api/v4/projects/{id}/packages/conan/v2/conans/{package_name}/{package_version}/{package_username}/{package_channel}/revisions/{recipe_revision}

Deletes a specified recipe revision from the registry. If the recipe revision is the only one, the package is deleted as well. This feature was introduced in GitLab 18.1.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe Example: `df28fd816be3a119de5ce4d374436b25`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

List all recipe files

GET /api/v4/projects/{id}/packages/conan/v2/conans/{package_name}/{package_version}/{package_username}/{package_channel}/revisions/{recipe_revision}/files

Lists all recipe files from the package registry. This feature was introduced in GitLab 17.11.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe Example: `df28fd816be3a119de5ce4d374436b25`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanFilesList
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve a recipe file

GET /api/v4/projects/{id}/packages/conan/v2/conans/{package_name}/{package_version}/{package_username}/{package_channel}/revisions/{recipe_revision}/files/{file_name}

Retrieves a specified recipe file from the package registry. This feature was introduced in GitLab 17.8.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe Example: `df28fd816be3a119de5ce4d374436b25`
`file_name` Path, required	String	Name of the package file Allowed values: `conanfile.py`, `conanmanifest.txt`, `conan_sources.tgz`, `conan_export.tgz`, `conaninfo.txt`, `conan_package.tgz` Minimum length: `1` Example: `conanfile.py`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Upload a recipe file

PUT /api/v4/projects/{id}/packages/conan/v2/conans/{package_name}/{package_version}/{package_username}/{package_channel}/revisions/{recipe_revision}/files/{file_name}

Uploads a specified recipe file to the package registry. This feature was introduced in GitLab 17.10.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe Example: `df28fd816be3a119de5ce4d374436b25`
`file_name` Path, required	String	Name of the package file Allowed values: `conanfile.py`, `conanmanifest.txt`, `conan_sources.tgz`, `conan_export.tgz`, `conaninfo.txt`, `conan_package.tgz` Minimum length: `1` Example: `conanfile.py`

Request body (multipart/form-data)

Property	Type	Description
`file` Required	String (binary)	The package file to be published (generated by Multipart middleware)

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Workhorse authorize the Conan recipe file

PUT /api/v4/projects/{id}/packages/conan/v2/conans/{package_name}/{package_version}/{package_username}/{package_channel}/revisions/{recipe_revision}/files/{file_name}/authorize

Authorizes the Conan recipe file. This feature was introduced in GitLab 17.10.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe Example: `df28fd816be3a119de5ce4d374436b25`
`file_name` Path, required	String	Name of the package file Allowed values: `conanfile.py`, `conanmanifest.txt`, `conan_sources.tgz`, `conan_export.tgz`, `conaninfo.txt`, `conan_package.tgz` Minimum length: `1` Example: `conanfile.py`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve latest package revision

GET /api/v4/projects/{id}/packages/conan/v2/conans/{package_name}/{package_version}/{package_username}/{package_channel}/revisions/{recipe_revision}/packages/{conan_package_reference}/latest

Retrieves the revision hash and creation date of the latest package revision for a specified recipe revision and package reference. This feature was introduced in GitLab 17.11.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe Example: `df28fd816be3a119de5ce4d374436b25`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `5ab84d6acfe1f23c4fae0ab88f26e3a396351ac9`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanRevision
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

List all package revisions

GET /api/v4/projects/{id}/packages/conan/v2/conans/{package_name}/{package_version}/{package_username}/{package_channel}/revisions/{recipe_revision}/packages/{conan_package_reference}/revisions

Lists all package revisions for a specified recipe revision and package reference. This feature was introduced in GitLab 18.0.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe Example: `df28fd816be3a119de5ce4d374436b25`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `5ab84d6acfe1f23c4fae0ab88f26e3a396351ac9`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanPackageRevisions
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Delete a package revision

DELETE /api/v4/projects/{id}/packages/conan/v2/conans/{package_name}/{package_version}/{package_username}/{package_channel}/revisions/{recipe_revision}/packages/{conan_package_reference}/revisions/{package_revision}

Deletes a specified package revision from the registry. If the package reference has only one package revision, the package reference is deleted as well. This feature was introduced in GitLab 18.1.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe Example: `df28fd816be3a119de5ce4d374436b25`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `5ab84d6acfe1f23c4fae0ab88f26e3a396351ac9`
`package_revision` Path, required	String	Revision of the package Example: `3bdd2d8c8e76c876ebd1ac0469a4e72c`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

List all package files

GET /api/v4/projects/{id}/packages/conan/v2/conans/{package_name}/{package_version}/{package_username}/{package_channel}/revisions/{recipe_revision}/packages/{conan_package_reference}/revisions/{package_revision}/files

Lists all package files. This feature was introduced in GitLab 18.0.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe Example: `df28fd816be3a119de5ce4d374436b25`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `5ab84d6acfe1f23c4fae0ab88f26e3a396351ac9`
`package_revision` Path, required	String	Revision of the package Example: `3bdd2d8c8e76c876ebd1ac0469a4e72c`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPackagesConanFilesList
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve a package file

Retrieves a specified package file from the package registry. This feature was introduced in GitLab 17.11.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe Example: `df28fd816be3a119de5ce4d374436b25`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `5ab84d6acfe1f23c4fae0ab88f26e3a396351ac9`
`package_revision` Path, required	String	Revision of the package Example: `3bdd2d8c8e76c876ebd1ac0469a4e72c`
`file_name` Path, required	String	Name of the package file Allowed values: `conanfile.py`, `conanmanifest.txt`, `conan_sources.tgz`, `conan_export.tgz`, `conaninfo.txt`, `conan_package.tgz` Minimum length: `1` Example: `conaninfo.txt`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Upload a package file

PUT /api/v4/projects/{id}/packages/conan/v2/conans/{package_name}/{package_version}/{package_username}/{package_channel}/revisions/{recipe_revision}/packages/{conan_package_reference}/revisions/{package_revision}/files/{file_name}

Uploads a specified package file to the package registry. This feature was introduced in GitLab 17.11.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe Example: `df28fd816be3a119de5ce4d374436b25`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `5ab84d6acfe1f23c4fae0ab88f26e3a396351ac9`
`package_revision` Path, required	String	Revision of the package Example: `3bdd2d8c8e76c876ebd1ac0469a4e72c`
`file_name` Path, required	String	Name of the package file Allowed values: `conanfile.py`, `conanmanifest.txt`, `conan_sources.tgz`, `conan_export.tgz`, `conaninfo.txt`, `conan_package.tgz` Minimum length: `1` Example: `conaninfo.txt`

Request body (multipart/form-data)

Property	Type	Description
`file` Required	String (binary)	The package file to be published (generated by Multipart middleware)

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Workhorse authorize the Conan package file

Authorizes the Conan package file. This feature was introduced in GitLab 17.11.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe Example: `df28fd816be3a119de5ce4d374436b25`
`conan_package_reference` Path, required	String	Reference hash of the Conan package. Conan generates this value Example: `5ab84d6acfe1f23c4fae0ab88f26e3a396351ac9`
`package_revision` Path, required	String	Revision of the package Example: `3bdd2d8c8e76c876ebd1ac0469a4e72c`
`file_name` Path, required	String	Name of the package file Allowed values: `conanfile.py`, `conanmanifest.txt`, `conan_sources.tgz`, `conan_export.tgz`, `conaninfo.txt`, `conan_package.tgz` Minimum length: `1` Example: `conaninfo.txt`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve package references metadata by recipe revision

GET /api/v4/projects/{id}/packages/conan/v2/conans/{package_name}/{package_version}/{package_username}/{package_channel}/revisions/{recipe_revision}/search

Retrieves the metadata for all package references associated with a specified recipe revision. This feature was introduced in GitLab 18.1.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`
`recipe_revision` Path, required	String	Revision of the recipe Example: `df28fd816be3a119de5ce4d374436b25`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve package references metadata

GET /api/v4/projects/{id}/packages/conan/v2/conans/{package_name}/{package_version}/{package_username}/{package_channel}/search

Retrieves the metadata for all package references of a specified package. This feature was introduced in GitLab 18.0.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project
`package_name` Path, required	String	Name of the package Example: `my-package`
`package_version` Path, required	String	Version of the package Example: `1.0`
`package_username` Path, required	String	Conan username of the package. This is the `+`-separated full path of the project Example: `my-group+my-project`
`package_channel` Path, required	String	Channel of the package Example: `stable`

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve an authentication token

GET /api/v4/projects/{id}/packages/conan/v2/users/authenticate

Retrieves an authentication token. Creates a JSON Web Token (JWT) for use as a Bearer header in other requests to the package registry.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`404`	Not Found	—

Verify authentication credentials

GET /api/v4/projects/{id}/packages/conan/v2/users/check_credentials

Verifies authentication credentials for a Conan package registry.

Parameters

Name	Type	Description
`id` Path, required	String or integer	ID or URL-encoded path of the project

Responses

Code	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`401`	Unauthorized	—
`404`	Not Found	—

Schemas

Objects returned by the operations above and objects nested in their request bodies.

APIEntitiesPackagesConanFilesList

Property	Type	Description
`files`	Object	Example: `{"conan_sources.tgz":{},"conanfile.py":{},"conanmanifest.txt":{}}`

APIEntitiesPackagesConanPackageManifest

Property	Type	Description
`package_urls`	Object	Example: `{"conan_package.tgz":"https://gitlab.example.com/api/v4/packages/conan/v1/files/my-package/1.0/my-group+my-project/stable/packages/103f6067a947f366ef91fc1b7da351c588d1827f/0/conan_package.tgz"}`

APIEntitiesPackagesConanPackageRevisions

Property	Type	Description
`packageReference`	String	The Conan package reference Example: `packageTest/1.2.3@gitlab-org+conan/stable#1883c9f810f2d6e5b59d5285c7141970:133a1f2158ff2cf69739f316ec21143785be54c7`
`revisions`	Array of APIEntitiesPackagesConanRevision	List of package revisions

APIEntitiesPackagesConanPackageSnapshot

Property	Type	Description
`package_snapshot`	Object	Example: `{"conan_package.tgz":"749b29bdf72587081ca03ec033ee59dc"}`

APIEntitiesPackagesConanRecipeManifest

Property	Type	Description
`recipe_urls`	Object	Example: `{"conan_sources.tgz":"https://gitlab.example.com/api/v4/packages/conan/v1/files/my-package/1.0/my-group+my-project/stable/0/export/conan_sources.tgz"}`

APIEntitiesPackagesConanRecipeRevisions

Property	Type	Description
`reference`	String	The Conan package reference Example: `packageTest/1.2.3@gitlab-org+conan/stable`
`revisions`	Array of APIEntitiesPackagesConanRevision	List of recipe revisions

APIEntitiesPackagesConanRecipeSnapshot

Property	Type	Description
`recipe_snapshot`	Object	Example: `{"conan_sources.tgz":"eadf19b33f4c3c7e113faabf26e76277"}`

APIEntitiesPackagesConanRevision

Property	Type	Description
`revision`	String	The revision hash of the Conan recipe or package Example: `75151329520e7685dcf5da49ded2fec0`
`time`	String	The UTC timestamp when the revision was created Example: `2024-12-17T09:16:40.334Z`

APIEntitiesPackagesConanUploadUrls

Property	Type	Description
`upload_urls`	Object	Example: `{"conan_package.tgz":"https://gitlab.example.com/api/v4/packages/conan/v1/files/my-package/1.0/my-group+my-project/stable/0/package/103f6067a947f366ef91fc1b7da351c588d1827f/0/conan_package.tgz"}`

Search for a Conan package

Retrieve a recipe snapshot

Delete a recipe and package

Retrieve a recipe manifest

List all recipe download URLs

Retrieve a package snapshot

Retrieve a package manifest

List all package download URLs

List all package upload URLs

Retrieve package references metadata

List all recipe upload URLs

Retrieve a recipe file

Upload a recipe file

Workhorse authorize the Conan recipe file

Retrieve a package file

Upload a package file

Workhorse authorize the Conan package file

Verify availability of a Conan repository

Retrieve an authentication token

Verify authentication credentials

Search for a Conan package

Retrieve a recipe snapshot

Delete a recipe and package

Retrieve a recipe manifest

List all recipe download URLs

Retrieve a package snapshot

Retrieve a package manifest

List all package download URLs

List all package upload URLs

Retrieve package references metadata

List all recipe upload URLs

Retrieve a recipe file

Upload a recipe file

Workhorse authorize the Conan recipe file

Retrieve a package file

Upload a package file

Workhorse authorize the Conan package file

Verify availability of a Conan repository

Retrieve an authentication token

Verify authentication credentials

Search for a Conan package

Retrieve latest recipe revision

List all recipe revisions

Delete recipe revision

List all recipe files

Retrieve a recipe file

Upload a recipe file

Workhorse authorize the Conan recipe file

Retrieve latest package revision

List all package revisions

Delete a package revision

List all package files

Retrieve a package file

Upload a package file

Workhorse authorize the Conan package file

Retrieve package references metadata by recipe revision

Retrieve package references metadata

Retrieve an authentication token

Verify authentication credentials

Schemas

APIEntitiesPackagesConanFilesList

APIEntitiesPackagesConanPackageManifest

APIEntitiesPackagesConanPackageRevisions

APIEntitiesPackagesConanPackageSnapshot

APIEntitiesPackagesConanRecipeManifest

APIEntitiesPackagesConanRecipeRevisions

APIEntitiesPackagesConanRecipeSnapshot

APIEntitiesPackagesConanRevision

APIEntitiesPackagesConanUploadUrls

Request trial access

Thank you

Error

Request callback

Thank you

Something went wrong

Book your sessions

Thank you

Error

Request demo