Manual
CLI
API
Log in Get started free

List GitLab repositories

Lists the repositories you can link through a connected account, without archived ones.

Lists the repositories you can link through a connected account, without archived ones.

HTTP
GET /integrations/gitlab/repositories

Access: Session token only. API keys get 403 with insufficient_scope.

Role: Organisation owner or admin.

Query parameters #

ParameterRequiredDescription
connectionIdyesThe connectionId of a connected account, from the overview.

Response 200 #

A list of repositories.

JSON
[
  { "fullName": "acme/shop", "private": true, "defaultBranch": "main", "archived": false, "linkedProjectId": null }
]

Response fields #

FieldTypeDescription
fullNamestringThe repository, such as acme/shop.
privatebooleanWhether it is private.
defaultBranchstringIts default branch.
archivedbooleanAlways false: archived repositories are left out.
linkedProjectIdstring or nullThe project it is linked to, if any.

Errors #

StatuserrorWhen
401unauthenticatedThe token is missing or not valid.
403forbiddenYou are not an owner or admin.
503gitlab_not_configuredThe GitLab integration is not set up on this server.
404not_foundThe account is not connected to your organisation.
502gitlab_errorGitLab refused the request. message says why.
429rate_limitedToo many requests, see Rate limiting.

See Errors for the error format.