Skip to content
Kapten
Esc
↑↓navigate↵open⌘Jpreview

List installation repositories

Returns the repositories the GitHub installation can read now.

GET/integration/github/installations/{installation_id}/repositories
Authorization
AuthorizationBearer token (JWT) · headerrequired

JWT token passed in the Authorization header using the Bearer <token> format.

Path parameters
installation_iduuidrequired

Kapten UUID of the GitHub installation binding.

Query parameters
pageinteger

One-based GitHub page number.

min 1 · default: 1
per_pageinteger

Number of GitHub records returned per page.

min 1 · max 100 · default: 50
Responses
200

Live GitHub repositories retrieved

recordsgithub_repository[]required
Show properties
Array of github_repository
idstringrequired
matches ^[1-9][0-9]*$
ownerstringrequired
namestringrequired
full_namestringrequired
privatebooleanrequired
default_branchstringrequired
archivedbooleanrequired
pageintegerrequired
min 1
per_pageintegerrequired
min 1 · max 100
total_countintegerrequired
min 0
next_pageinteger | null
min 1
422

Installation is inactive or inaccessible

codeinteger<int32>required
messagestringrequired
reasonstring

Optional stable machine-readable reason for programmatic error handling

503

GitHub is temporarily unavailable

codeinteger<int32>required
messagestringrequired
reasonstring

Optional stable machine-readable reason for programmatic error handling

default

Error

codeinteger<int32>required
messagestringrequired
reasonstring

Optional stable machine-readable reason for programmatic error handling

Request
curl -X GET 'https://api.kapten.io/integration/github/installations/497f6eca-6276-4993-bfeb-53cbbbba6f08/repositories' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
Response
{
  "records": [
    {
      "id": "string",
      "owner": "string",
      "name": "string",
      "full_name": "string",
      "private": true,
      "default_branch": "string",
      "archived": true
    }
  ],
  "page": 1,
  "per_page": 1,
  "total_count": 0,
  "next_page": 1
}

Was this page helpful?