Skip to main content
GET
List projects accessible to the caller (or one by name)

Authorizations

Authorization
string
header
required

Authorization code flow with PKCE-S256. RFC 8628 device flow is also supported.

Query Parameters

pageSize
integer<int32>

Maximum entries to return; server may cap further.

Required range: 0 <= x <= 500
pageToken
string

Opaque cursor from a previous response's nextPageToken.

name
string

Optional: exact-match project name (case-insensitive).

capabilities
enum<string>

Optional: live (default) checks GitHub namespace authority now. display may answer from a roster up to 70 minutes old; never use a display capability to authorize a write.

Available options:
live,
display
commitToken
string

Optional: opaque commit token from a project create or delete, to list at a snapshot that contains that write. Ignored when name is set.

Pattern: ^$|^[A-Za-z0-9_-]{20,512}$

Response

OK

$schema
string<uri>
read-only

A URL to the JSON Schema for this object.

Example:

"/api/v1/schemas/ListProjectsOutputBody.json"

nextPageToken
string

Pass back to fetch the next page; empty when no more entries.

project
object
projects
object[]