GET /v1/github/installations/{installation_id}/repositories
The repositories the installation lets B3OS read, by name. The list is kept from GitHub's events and read again from GitHub when it is more than an hour old, or with refresh=true (at most once a minute).

Authentication

Bearer Token (b3os_sk_ API key or b3os_pat_ token)

Path Parameters

installation_id integer required path
GitHub's id of the installation.
Min 1
Example: 61234567

Query Parameters

limit integer optional query
Page size, from 1 to 100.
Default 20Min 1Max 100
cursor string optional query
Opaque cursor from the previous page's next_cursor. Omit it for the first page.
Max length 512
refresh boolean optional query
Read the list from GitHub now.
Default false

Responses

200 A page of repositories.
application/json
object string REQUIRED
Values list
data object[] REQUIRED
Array of:
id integer REQUIRED
GitHub's id of the repository (it stays the same through a rename).
object string REQUIRED
Values github_repository
full_name string REQUIRED
owner/name.
private boolean REQUIRED
installation_id integer REQUIRED
next_cursor string | null REQUIRED
400 The request failed validation (invalid_request, invalid_url).
401 Missing, malformed, expired or revoked credentials (unauthorized).
403 Authenticated but not allowed (forbidden, egress_denied).
404 No such installation connected to your organization (github_installation_not_found).
429 A rate, concurrency or quota limit applies (rate_limited, concurrency_limited, quota_exceeded).
500 Something failed inside B3OS (internal). Retry with backoff.
503 The B3OS GitHub App is not set up on this deployment (github_app_not_configured).
curl -X GET 'https://beta-api.b3os.org/v1/github/installations/61234567/repositories' \  -H 'Authorization: Bearer YOUR_API_TOKEN'
const response = await fetch('https://beta-api.b3os.org/v1/github/installations/61234567/repositories', {  method: 'GET',  headers: {      "Authorization": "Bearer YOUR_API_TOKEN"  }});const data = await response.json();console.log(data);
import requestsheaders = {    'Authorization': 'Bearer YOUR_API_TOKEN'}response = requests.get('https://beta-api.b3os.org/v1/github/installations/61234567/repositories', headers=headers)print(response.json())
200 Response
{  "object": "list",  "data": [    {      "id": 812345678,      "object": "github_repository",      "full_name": "acme/research-agent",      "private": true,      "installation_id": 61234567    }  ],  "next_cursor": null}
Ask a question... ⌘I