Skip to content

List all remote mirrors for a project

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

Lists all remote mirrors for a specified project.

id
required
One of:
string

The ID or URL-encoded path of the project

page
integer
default: 1 nullable

Current page number

Example
1
per_page
integer
default: 20 nullable

Number of items per page

Example
20

OK

Media type application/json
object
id
integer format: int64
enabled
boolean
url
string
update_status
string
last_update_at
string format: date-time
last_update_started_at
string format: date-time
last_successful_update_at
string format: date-time
last_error
string
only_protected_branches
boolean
keep_divergent_refs
boolean
auth_method
string
host_keys
Array<object>
object
fingerprint_sha256
string
mirror_branch_regex
string
Example
{
"id": 101486,
"enabled": true,
"url": "https://*****:*****@example.com/gitlab/example.git",
"update_status": "finished",
"last_update_at": "2020-01-06T17:32:02.823Z",
"last_update_started_at": "2020-01-06T17:32:02.823Z",
"last_successful_update_at": "2020-01-06T17:31:55.864Z",
"last_error": "The remote mirror URL is invalid.",
"auth_method": "password",
"host_keys": [
{
"fingerprint_sha256": "SHA256:abcd1234"
}
],
"mirror_branch_regex": "feature-.*"
}

Bad Request

Unauthorized

Not found