gitlab-org--gitlab-foss/doc/api/project_aliases.md

Project Aliases API

All methods require administrator authorization.

List all project aliases

Get a list of all project aliases

GET /project_aliases

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/project_aliases"

Example response:

[
  {
    "id": 1,
    "project_id": 1,
    "name": "gitlab-ce"
  },
  {
    "id": 2,
    "project_id": 2,
    "name": "gitlab-ee"
  }
]

Get project alias' details

Get details of a project alias

GET /project_aliases/:name

Attribute	Type	Required	Description
name	string	yes	The name of the alias

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/project_aliases/gitlab-ee"

Example response:

{
  "id": 1,
  "project_id": 1,
  "name": "gitlab-ee"
}

Create an alias for a project

Add a new alias for a project. Reponds with a 201 when successful, 400 when there are validation errors (e.g. alias already exists).

POST /project_aliases

Attribute	Type	Required	Description
project_id	string	yes	The The ID or URL-encoded path of the project
name	string	yes	The name of the alias. Must be unique.

curl --request POST "https://gitlab.example.com/api/v4/project_aliases" --form "project_id=gitlab-org%2Fgitlab-ee" --form "name=gitlab-ee"

Example response:

{
  "id": 1,
  "project_id": 1,
  "name": "gitlab-ee"
}

Delete a project aliase

Removes a project aliases. Respond with a 204 when project alias exists, 404 when it doesn't.

DELETE /project_aliases/:name

Attribute	Type	Required	Description
name	string	yes	The name of the alias

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/project_aliases/gitlab-ee"