Lists the repositories you can link through a connected account, without archived ones.
HTTP
GET /integrations/github/repositoriesAccess: Session token only. API keys get 403 with insufficient_scope.
Role: Organisation owner or admin.
Query parameters #
| Parameter | Required | Description |
|---|---|---|
installationId | yes | The installationId 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 #
| Field | Type | Description |
|---|---|---|
fullName | string | The repository, such as acme/shop. |
private | boolean | Whether it is private. |
defaultBranch | string | Its default branch. |
archived | boolean | Always false: archived repositories are left out. |
linkedProjectId | string or null | The project it is linked to, if any. |
Errors #
| Status | error | When |
|---|---|---|
| 401 | unauthenticated | The token is missing or not valid. |
| 403 | forbidden | You are not an owner or admin. |
| 503 | github_not_configured | The GitHub integration is not set up on this server. |
| 404 | not_found | The account is not connected to your organisation. |
| 502 | github_error | GitHub refused the request. message says why. |
| 429 | rate_limited | Too many requests, see Rate limiting. |
See Errors for the error format.