Skip to main content
GET
/
repos
List GitHub repositories available to Box
curl --request GET \
  --url https://ascii.dev/api/box/v1/repos \
  --header 'Authorization: Bearer <token>'
{
  "ok": true,
  "type": "repos.list",
  "environmentId": "env_123",
  "installations": [
    {
      "type": "Organization",
      "accountLogin": "acme",
      "accountAvatarUrl": "https://github.com/acme.png",
      "repositories": [
        {
          "id": 123456,
          "databaseId": "repo_org_123456",
          "name": "web",
          "fullName": "acme/web",
          "description": "Marketing site",
          "url": "https://github.com/acme/web",
          "private": true,
          "permissions": "admin",
          "pushedAt": "2026-05-31T12:00:00Z"
        }
      ]
    }
  ],
  "selectedRepositories": [
    {
      "id": 123456,
      "databaseId": "repo_org_123456",
      "name": "web",
      "fullName": "acme/web",
      "private": true,
      "permissions": "admin",
      "pushedAt": "2026-05-31T12:00:00Z",
      "baseBranch": "dev",
      "setupRoutineId": null,
      "setupScript": "",
      "setupBlocking": false,
      "preCommitHooks": []
    }
  ]
}

Authorizations

Authorization
string
header
required

Box API key in the form box_.... Create and rotate keys in the Box dashboard or through the v1 API key endpoints.

Query Parameters

sync
boolean

When true, sync from GitHub before returning repository groups.

limit
integer
default:100

Maximum items to return.

Required range: 1 <= x <= 200
cursor
string | null

Opaque pagination cursor returned as pageInfo.nextCursor.

sort
enum<string>
default:desc

Sort direction for cursor pagination.

Available options:
asc,
desc
q
string

Case-insensitive repository name/fullName filter.

selected
boolean

Filter to selected or unselected repositories.

Response

Repository groups and current Box repository selection.

ok
boolean
required
Example:

true

type
string
required

Stable success envelope discriminator added by v1.

installations
object[]
required
environmentId
string
required
selectedRepositories
object[]
required
pageInfo
object