List repositories for a repository connection

The repository connections API endpoint lets you list repositories available to a repository connection in your organization.

List repositories

Returns the repositories available to the specified repository connection, in provider order.

This endpoint is supported for GitHub, GitHub Limited Access, GitHub Restricted, and GitHub Enterprise Server (GHES) connections. For Bitbucket Server, GitLab Self-Managed, and GHES Legacy connections, the endpoint returns 422 Unprocessable Entity.

curl -H "Authorization: Bearer $TOKEN" \
  -X GET "https://api.buildkite.com/v2/organizations/{org.slug}/repository_connections/{repository_connection.id}/repositories"

[
  {
    "full_name": "acme/widgets",
    "html_url": "https://github.com/acme/widgets",
    "clone_url": "https://github.com/acme/widgets.git",
    "default_branch": "main"
  },
  {
    "full_name": "acme/gadgets",
    "html_url": "https://github.com/acme/gadgets",
    "clone_url": "https://github.com/acme/gadgets.git",
    "default_branch": "trunk"
  }
]

Repository data model

full_name Full name of the repository in owner/repo format
html_url URL of the repository on the source control provider
clone_url HTTPS clone URL for the repository
default_branch Default branch of the repository

Query parameters

repository Optional. Filter results to the repository whose full_name matches this value (case-insensitive exact match). Returns an empty list if no repository matches. Returns 400 Bad Request if the value is not a string.

Required scope: read_organization_repository_connections

Required permission: organization administrator privileges (the change_organization permission)

Success response: 200 OK

Error responses:

  • 400 Bad Request: malformed connection ID, or the repository parameter is not a string
  • 403 Forbidden: the token does not have the read_organization_repository_connections scope, or the authenticated user does not have the change_organization permission
  • 404 Not Found: connection not found or belongs to another organization
  • 422 Unprocessable Entity: the connection type does not support repository listing
  • 503 Service Unavailable: the upstream source control provider is temporarily unavailable; may include a Retry-After response header indicating when to retry