Project Aliases API
Tier: Premium, Ultimate
Offering: Self-managed, GitLab Dedicated
Offering: Self-managed, GitLab Dedicated
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-foss"
},
{
"id": 2,
"project_id": 2,
"name": "gitlab"
}
]
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"
Example response:
{
"id": 1,
"project_id": 1,
"name": "gitlab"
}
Create a project alias
Add a new alias for a project. When successful, responds with 201 Created
.
When there are validation errors, for example, when the alias already exists, responds with 400 Bad Request
:
POST /project_aliases
Attribute | Type | Required | Description |
---|---|---|---|
name
| string | Yes | The name of the alias. Must be unique. |
project_id
| integer or string | Yes | The ID or path of the project. |
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
"https://gitlab.example.com/api/v4/project_aliases" --form "project_id=1" --form "name=gitlab"
or
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
"https://gitlab.example.com/api/v4/project_aliases" --form "project_id=gitlab-org/gitlab" --form "name=gitlab"
Example response:
{
"id": 1,
"project_id": 1,
"name": "gitlab"
}
Delete a project alias
Removes a project aliases. Responds 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"