Packages: Debian

These endpoints are under development and are not ready for production use due to limited functionality. The package endpoints are used by Debian package clients such as dput and apt-get, and are generally not meant for manual consumption.

Use this API to manage Debian distributions for groups and projects, and to publish and retrieve Debian packages. The distribution endpoints are behind a feature flag that is disabled by default. To use them, enable the group or project Debian API.

These endpoints do not adhere to the standard API authentication methods. For the supported headers and token types, see the Debian registry documentation. Undocumented authentication methods might be removed in the future.

List all Debian group distributions

GET /api/v4/groups/{id}/-/debian_distributions

Lists all Debian distributions for a specified group.

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the group
`page` Query	Integer	Current page number Default: `1` Example: `1`
`per_page` Query	Integer	Number of items per page Default: `20` Example: `20`
`codename` Query	String	The Debian Codename Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `sid`
`suite` Query	String	The Debian Suite Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `unstable`
`origin` Query	String	The Debian Origin Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `Grep`
`label` Query	String	The Debian Label Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `grep.be`
`version` Query	String	The Debian Version Pattern: `(?:^(?:(?:([0-9]{1,9}):)?([0-9][+.0-9A-Za-z~\u017F\u212A]*)(-[+.0-9A-Za-z~\u017F\u212A]+){0,14}(?<!-))$)` Example: `12`
`description` Query	String	The Debian Description Example: `My description`
`valid_time_duration_seconds` Query	Integer	The duration before the Release file should be considered expired by the client Example: `604800`
`components` Query	Array of strings	The list of Components Example: `["main"]`
`architectures` Query	Array of strings	The list of Architectures Example: `["amd64"]`

Responses

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

Create a Debian group distribution

POST /api/v4/groups/{id}/-/debian_distributions

Creates a Debian group distribution for a specified group.

Parameters

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

Request body (application/json)

Property	Type	Description
`architectures`	Array of strings	The list of Architectures
`codename` Required	String	The Debian Codename Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `sid`
`components`	Array of strings	The list of Components
`description`	String	The Debian Description Example: `My description`
`label`	String	The Debian Label Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `grep.be`
`origin`	String	The Debian Origin Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `Grep`
`suite`	String	The Debian Suite Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `unstable`
`valid_time_duration_seconds`	Integer	The duration before the Release file should be considered expired by the client Example: `604800`

Responses

Code	Description	Schema
`201`	Created	APIEntitiesPackagesDebianDistribution
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve a Debian group distribution

GET /api/v4/groups/{id}/-/debian_distributions/{codename}

Retrieves a specified Debian group distribution for a group.

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the group
`codename` Path, required	String	The Debian Codename Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `sid`

Responses

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

Update a Debian group distribution

PUT /api/v4/groups/{id}/-/debian_distributions/{codename}

Updates a specified Debian group distribution for a group.

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the group
`codename` Path, required	String	The Debian Codename Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `sid`

Request body (application/json)

Property	Type	Description
`architectures`	Array of strings	The list of Architectures
`components`	Array of strings	The list of Components
`description`	String	The Debian Description Example: `My description`
`label`	String	The Debian Label Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `grep.be`
`origin`	String	The Debian Origin Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `Grep`
`suite`	String	The Debian Suite Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `unstable`
`valid_time_duration_seconds`	Integer	The duration before the Release file should be considered expired by the client Example: `604800`

Responses

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

Delete a Debian group distribution

DELETE /api/v4/groups/{id}/-/debian_distributions/{codename}

Deletes a specified Debian group distribution for a group.

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the group
`codename` Path, required	String	The Debian Codename Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `sid`
`suite` Query	String	The Debian Suite Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `unstable`
`origin` Query	String	The Debian Origin Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `Grep`
`label` Query	String	The Debian Label Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `grep.be`
`version` Query	String	The Debian Version Pattern: `(?:^(?:(?:([0-9]{1,9}):)?([0-9][+.0-9A-Za-z~\u017F\u212A]*)(-[+.0-9A-Za-z~\u017F\u212A]+){0,14}(?<!-))$)` Example: `12`
`description` Query	String	The Debian Description Example: `My description`
`valid_time_duration_seconds` Query	Integer	The duration before the Release file should be considered expired by the client Example: `604800`
`components` Query	Array of strings	The list of Components Example: `["main"]`
`architectures` Query	Array of strings	The list of Architectures Example: `["amd64"]`

Responses

Code	Description	Schema
`202`	Accepted	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve a Debian group distribution key

GET /api/v4/groups/{id}/-/debian_distributions/{codename}/key.asc

Retrieves a specified Debian group distribution key for a group.

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the group
`codename` Path, required	String	The Debian Codename Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `sid`

Responses

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

The signed Release file

GET /api/v4/groups/{id}/-/packages/debian/dists/{distribution}/InRelease

This feature was introduced in GitLab 13.5

Parameters

Name	Type	Description
`id` Path, required	String or integer	The group ID or full group path
`distribution` Path, required	String	The Debian Codename or Suite Example: `my-distro`

Responses

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

The unsigned Release file

GET /api/v4/groups/{id}/-/packages/debian/dists/{distribution}/Release

This feature was introduced in GitLab 13.5

Parameters

Name	Type	Description
`id` Path, required	String or integer	The group ID or full group path
`distribution` Path, required	String	The Debian Codename or Suite Example: `my-distro`

Responses

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

The Release file signature

GET /api/v4/groups/{id}/-/packages/debian/dists/{distribution}/Release.gpg

This feature was introduced in GitLab 13.5

Parameters

Name	Type	Description
`id` Path, required	String or integer	The group ID or full group path
`distribution` Path, required	String	The Debian Codename or Suite Example: `my-distro`

Responses

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

The binary files index

GET /api/v4/groups/{id}/-/packages/debian/dists/{distribution}/{component}/binary-{architecture}/Packages

This feature was introduced in GitLab 13.5

Parameters

Name	Type	Description
`id` Path, required	String or integer	The group ID or full group path
`distribution` Path, required	String	The Debian Codename or Suite Example: `my-distro`
`component` Path, required	String	The Debian Component Example: `main`
`architecture` Path, required	String	The Debian Architecture Example: `binary-amd64`

Responses

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

The binary files index by hash

GET /api/v4/groups/{id}/-/packages/debian/dists/{distribution}/{component}/binary-{architecture}/by-hash/SHA256/{file_sha256}

This feature was introduced in GitLab 15.4

Parameters

Name	Type	Description
`id` Path, required	String or integer	The group ID or full group path
`distribution` Path, required	String	The Debian Codename or Suite Example: `my-distro`
`component` Path, required	String	The Debian Component Example: `main`
`architecture` Path, required	String	The Debian Architecture Example: `binary-amd64`
`file_sha256` Path, required	String	The SHA256 checksum of the index file

Responses

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

The installer (udeb) binary files index

GET /api/v4/groups/{id}/-/packages/debian/dists/{distribution}/{component}/debian-installer/binary-{architecture}/Packages

This feature was introduced in GitLab 15.4

Parameters

Name	Type	Description
`id` Path, required	String or integer	The group ID or full group path
`distribution` Path, required	String	The Debian Codename or Suite Example: `my-distro`
`component` Path, required	String	The Debian Component Example: `main`
`architecture` Path, required	String	The Debian Architecture Example: `binary-amd64`

Responses

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

The installer (udeb) binary files index by hash

GET /api/v4/groups/{id}/-/packages/debian/dists/{distribution}/{component}/debian-installer/binary-{architecture}/by-hash/SHA256/{file_sha256}

This feature was introduced in GitLab 15.4

Parameters

Name	Type	Description
`id` Path, required	String or integer	The group ID or full group path
`distribution` Path, required	String	The Debian Codename or Suite Example: `my-distro`
`component` Path, required	String	The Debian Component Example: `main`
`architecture` Path, required	String	The Debian Architecture Example: `binary-amd64`
`file_sha256` Path, required	String	The SHA256 checksum of the index file

Responses

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

The source files index

GET /api/v4/groups/{id}/-/packages/debian/dists/{distribution}/{component}/source/Sources

This feature was introduced in GitLab 15.4

Parameters

Name	Type	Description
`id` Path, required	String or integer	The group ID or full group path
`distribution` Path, required	String	The Debian Codename or Suite Example: `my-distro`
`component` Path, required	String	The Debian Component Example: `main`

Responses

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

The source files index by hash

GET /api/v4/groups/{id}/-/packages/debian/dists/{distribution}/{component}/source/by-hash/SHA256/{file_sha256}

This feature was introduced in GitLab 15.4

Parameters

Name	Type	Description
`id` Path, required	String or integer	The group ID or full group path
`distribution` Path, required	String	The Debian Codename or Suite Example: `my-distro`
`component` Path, required	String	The Debian Component Example: `main`
`file_sha256` Path, required	String	The SHA256 checksum of the index file

Responses

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

Download Debian package

GET /api/v4/groups/{id}/-/packages/debian/pool/{distribution}/{project_id}/{letter}/{package_name}/{package_version}/{file_name}

This feature was introduced in GitLab 14.2

Parameters

Name	Type	Description
`id` Path, required	String or integer	The group ID or full group path
`project_id` Path, required	Integer	The Project Id
`distribution` Path, required	String	The Debian distribution name Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `my-distro`
`letter` Path, required	String	The package name first letter Example: `a`
`package_name` Path, required	String	The package name Pattern: `^[a-z0-9][\-+.a-z0-9]+$` Example: `my-pkg`
`package_version` Path, required	String	The package version Pattern: `(?:^(?:(?:([0-9]{1,9}):)?([0-9][+.0-9A-Za-z~\u017F\u212A]*)(-[+.0-9A-Za-z~\u017F\u212A]+){0,14}(?<!-))$)` Example: `1.0.0`
`file_name` Path, required	String	The package file name Example: `example_1.0.0~alpha2_amd64.deb`

Responses

Code	Description	Schema
`200`	OK	String (binary) (`application/octet-stream`)
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

List all Debian project distributions

GET /api/v4/projects/{id}/debian_distributions

Lists all Debian distributions for a specified project.

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the project
`page` Query	Integer	Current page number Default: `1` Example: `1`
`per_page` Query	Integer	Number of items per page Default: `20` Example: `20`
`codename` Query	String	The Debian Codename Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `sid`
`suite` Query	String	The Debian Suite Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `unstable`
`origin` Query	String	The Debian Origin Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `Grep`
`label` Query	String	The Debian Label Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `grep.be`
`version` Query	String	The Debian Version Pattern: `(?:^(?:(?:([0-9]{1,9}):)?([0-9][+.0-9A-Za-z~\u017F\u212A]*)(-[+.0-9A-Za-z~\u017F\u212A]+){0,14}(?<!-))$)` Example: `12`
`description` Query	String	The Debian Description Example: `My description`
`valid_time_duration_seconds` Query	Integer	The duration before the Release file should be considered expired by the client Example: `604800`
`components` Query	Array of strings	The list of Components Example: `["main"]`
`architectures` Query	Array of strings	The list of Architectures Example: `["amd64"]`

Responses

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

Create a Debian project distribution

POST /api/v4/projects/{id}/debian_distributions

Creates a Debian project distribution for a specified project.

Parameters

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

Request body (application/json)

Property	Type	Description
`architectures`	Array of strings	The list of Architectures
`codename` Required	String	The Debian Codename Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `sid`
`components`	Array of strings	The list of Components
`description`	String	The Debian Description Example: `My description`
`label`	String	The Debian Label Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `grep.be`
`origin`	String	The Debian Origin Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `Grep`
`suite`	String	The Debian Suite Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `unstable`
`valid_time_duration_seconds`	Integer	The duration before the Release file should be considered expired by the client Example: `604800`

Responses

Code	Description	Schema
`201`	Created	APIEntitiesPackagesDebianDistribution
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve a Debian project distribution

GET /api/v4/projects/{id}/debian_distributions/{codename}

Retrieves a specified Debian project distribution for a project.

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the project
`codename` Path, required	String	The Debian Codename Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `sid`

Responses

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

Update a Debian project distribution

PUT /api/v4/projects/{id}/debian_distributions/{codename}

Updates a specified Debian project distribution for a project.

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the project
`codename` Path, required	String	The Debian Codename Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `sid`

Request body (application/json)

Property	Type	Description
`architectures`	Array of strings	The list of Architectures
`components`	Array of strings	The list of Components
`description`	String	The Debian Description Example: `My description`
`label`	String	The Debian Label Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `grep.be`
`origin`	String	The Debian Origin Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `Grep`
`suite`	String	The Debian Suite Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `unstable`
`valid_time_duration_seconds`	Integer	The duration before the Release file should be considered expired by the client Example: `604800`

Responses

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

Delete a Debian project distribution

DELETE /api/v4/projects/{id}/debian_distributions/{codename}

Deletes a specified Debian project distribution for a project.

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the project
`codename` Path, required	String	The Debian Codename Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `sid`
`suite` Query	String	The Debian Suite Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `unstable`
`origin` Query	String	The Debian Origin Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `Grep`
`label` Query	String	The Debian Label Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `grep.be`
`version` Query	String	The Debian Version Pattern: `(?:^(?:(?:([0-9]{1,9}):)?([0-9][+.0-9A-Za-z~\u017F\u212A]*)(-[+.0-9A-Za-z~\u017F\u212A]+){0,14}(?<!-))$)` Example: `12`
`description` Query	String	The Debian Description Example: `My description`
`valid_time_duration_seconds` Query	Integer	The duration before the Release file should be considered expired by the client Example: `604800`
`components` Query	Array of strings	The list of Components Example: `["main"]`
`architectures` Query	Array of strings	The list of Architectures Example: `["amd64"]`

Responses

Code	Description	Schema
`202`	Accepted	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Retrieve a Debian project distribution key

GET /api/v4/projects/{id}/debian_distributions/{codename}/key.asc

Retrieves a specified Debian project distribution key for a project.

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the project
`codename` Path, required	String	The Debian Codename Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `sid`

Responses

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

The signed Release file

GET /api/v4/projects/{id}/packages/debian/dists/{distribution}/InRelease

This feature was introduced in GitLab 13.5

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the project
`distribution` Path, required	String	The Debian Codename or Suite Example: `my-distro`

Responses

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

The unsigned Release file

GET /api/v4/projects/{id}/packages/debian/dists/{distribution}/Release

This feature was introduced in GitLab 13.5

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the project
`distribution` Path, required	String	The Debian Codename or Suite Example: `my-distro`

Responses

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

The Release file signature

GET /api/v4/projects/{id}/packages/debian/dists/{distribution}/Release.gpg

This feature was introduced in GitLab 13.5

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the project
`distribution` Path, required	String	The Debian Codename or Suite Example: `my-distro`

Responses

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

The binary files index

GET /api/v4/projects/{id}/packages/debian/dists/{distribution}/{component}/binary-{architecture}/Packages

This feature was introduced in GitLab 13.5

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the project
`distribution` Path, required	String	The Debian Codename or Suite Example: `my-distro`
`component` Path, required	String	The Debian Component Example: `main`
`architecture` Path, required	String	The Debian Architecture Example: `binary-amd64`

Responses

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

The binary files index by hash

GET /api/v4/projects/{id}/packages/debian/dists/{distribution}/{component}/binary-{architecture}/by-hash/SHA256/{file_sha256}

This feature was introduced in GitLab 15.4

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the project
`distribution` Path, required	String	The Debian Codename or Suite Example: `my-distro`
`component` Path, required	String	The Debian Component Example: `main`
`architecture` Path, required	String	The Debian Architecture Example: `binary-amd64`
`file_sha256` Path, required	String	The SHA256 checksum of the index file

Responses

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

The installer (udeb) binary files index

GET /api/v4/projects/{id}/packages/debian/dists/{distribution}/{component}/debian-installer/binary-{architecture}/Packages

This feature was introduced in GitLab 15.4

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the project
`distribution` Path, required	String	The Debian Codename or Suite Example: `my-distro`
`component` Path, required	String	The Debian Component Example: `main`
`architecture` Path, required	String	The Debian Architecture Example: `binary-amd64`

Responses

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

The installer (udeb) binary files index by hash

GET /api/v4/projects/{id}/packages/debian/dists/{distribution}/{component}/debian-installer/binary-{architecture}/by-hash/SHA256/{file_sha256}

This feature was introduced in GitLab 15.4

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the project
`distribution` Path, required	String	The Debian Codename or Suite Example: `my-distro`
`component` Path, required	String	The Debian Component Example: `main`
`architecture` Path, required	String	The Debian Architecture Example: `binary-amd64`
`file_sha256` Path, required	String	The SHA256 checksum of the index file

Responses

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

The source files index

GET /api/v4/projects/{id}/packages/debian/dists/{distribution}/{component}/source/Sources

This feature was introduced in GitLab 15.4

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the project
`distribution` Path, required	String	The Debian Codename or Suite Example: `my-distro`
`component` Path, required	String	The Debian Component Example: `main`

Responses

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

The source files index by hash

GET /api/v4/projects/{id}/packages/debian/dists/{distribution}/{component}/source/by-hash/SHA256/{file_sha256}

This feature was introduced in GitLab 15.4

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the project
`distribution` Path, required	String	The Debian Codename or Suite Example: `my-distro`
`component` Path, required	String	The Debian Component Example: `main`
`file_sha256` Path, required	String	The SHA256 checksum of the index file

Responses

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

Download a Debian package file

GET /api/v4/projects/{id}/packages/debian/pool/{distribution}/{letter}/{package_name}/{package_version}/{file_name}

Downloads a specified Debian package file for a project.

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the project
`distribution` Path, required	String	The Debian Codename or Suite Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)` Example: `my-distro`
`letter` Path, required	String	The Debian Classification (first-letter or lib-first-letter) Example: `a`
`package_name` Path, required	String	The Debian Source Package Name Pattern: `^[a-z0-9][\-+.a-z0-9]+$` Example: `my-pkg`
`package_version` Path, required	String	The Debian Source Package Version Pattern: `(?:^(?:(?:([0-9]{1,9}):)?([0-9][+.0-9A-Za-z~\u017F\u212A]*)(-[+.0-9A-Za-z~\u017F\u212A]+){0,14}(?<!-))$)` Example: `1.0.0`
`file_name` Path, required	String	The Debian File Name Example: `example_1.0.0~alpha2_amd64.deb`

Responses

Code	Description	Schema
`200`	OK	String (binary) (`application/octet-stream`)
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Upload a Debian package file

PUT /api/v4/projects/{id}/packages/debian/{file_name}

Uploads a Debian package file for a specified project.

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the project
`file_name` Path, required	String	The filename Pattern: `^(?:[\uD800-\uDBFF][\uDC00-\uDFFF]\|[^\n\uD800-\uDFFF])*\.(deb\|udeb\|ddeb)$` Example: `example_1.0.0~alpha2_amd64.deb`

Request body (multipart/form-data)

Property	Type	Description
`component` Required	String	The Debian Component Pattern: `^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$`
`distribution`	String	The Debian Codename or Suite Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)`
`file` Required	String (binary)	The package file to be published (generated by Multipart middleware)

Responses

Code	Description	Schema
`201`	Created	—
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—
`404`	Not Found	—

Authorize Debian package upload

PUT /api/v4/projects/{id}/packages/debian/{file_name}/authorize

This feature was introduced in GitLab 13.5

Parameters

Name	Type	Description
`id` Path, required	String or integer	The ID or URL-encoded path of the project
`file_name` Path, required	String	The filename Pattern: `^(?:[\uD800-\uDBFF][\uDC00-\uDFFF]\|[^\n\uD800-\uDFFF])*\.(deb\|udeb\|ddeb)$` Example: `example_1.0.0~alpha2_amd64.deb`

Request body (application/json)

Property	Type	Description
`component` Required	String	The Debian Component Pattern: `^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$`
`distribution`	String	The Debian Codename or Suite Pattern: `(?:^(?:[0-9A-Za-z\u017F\u212A][\x2D.0-9A-Za-z\u017F\u212A]*)$)`

Responses

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

Schemas

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

APIEntitiesPackagesDebianDistribution

Property	Type	Description
`architectures`	Array of strings	Example: `["amd64"]`
`codename`	String	Example: `sid`
`components`	Array of strings	Example: `["main"]`
`description`	String	Example: `My description`
`id`	Integer (int64)	Example: `1`
`label`	String	Example: `grep.be`
`origin`	String	Example: `Grep`
`suite`	String	Example: `unstable`
`valid_time_duration_seconds`	Integer	Example: `604800`
`version`	String	Example: `12`

List all Debian group distributions

Create a Debian group distribution

Retrieve a Debian group distribution

Update a Debian group distribution

Delete a Debian group distribution

Retrieve a Debian group distribution key

The signed Release file

The unsigned Release file

The Release file signature

The binary files index

The binary files index by hash

The installer (udeb) binary files index

The installer (udeb) binary files index by hash

The source files index

The source files index by hash

Download Debian package

List all Debian project distributions

Create a Debian project distribution

Retrieve a Debian project distribution

Update a Debian project distribution

Delete a Debian project distribution

Retrieve a Debian project distribution key

The signed Release file

The unsigned Release file

The Release file signature

The binary files index

The binary files index by hash

The installer (udeb) binary files index

The installer (udeb) binary files index by hash

The source files index

The source files index by hash

Download a Debian package file

Upload a Debian package file

Authorize Debian package upload

Schemas

APIEntitiesPackagesDebianDistribution

Request trial access

Thank you

Error

Request callback

Thank you

Something went wrong

Book your sessions

Thank you

Error

Request demo

Thank you

Error

Get the PCI SSC Compliance Report

Thank you

Error