OAuth App Registrations

List OAuth app registrations

Changed on

List OAuth application registrations with cursor-based pagination.

Admin-only: the full view carries endpoints, created_by, inactive rows and org-wide dependent-credential counts. Non-admins discover the shared apps they can connect through via GET /vendors.

get/oauth-app-registrations

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /oauth-app-registrations
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL /authorize, token URL /oauth/token)

Query parameters

api_vendorstring nullable

Filter by vendor slug.

Example:github
include_inactiveboolean

Include registrations with is_active=false in the response.

Example:true
flow_kind'authorization_code' | 'device_authorization'

Which OAuth flow a registration supports.

Filter by OAuth flow kind.

cursorstring nullable

Opaque cursor from a previous page's next_cursor; omit for the first page.

Example:eyJ0IjogIjIwMjYtMDEtMTVUMDk6MzA6MDArMDA6MDAiLCAiaWQiOiAiM2YyYjhjMWUtN2Q0YS00ZTliLWE2YzUtMWQyZTNmNGE1YjZjIn0=
limitinteger

Maximum number of registrations to return (1-200, default 50).

Example:25

Response

Successful Response

has_moreboolean required

Whether more results exist after this page.

next_cursorstring nullable

Cursor for the next page; null when there are no more results.

Example response

{
  "data": [
    {
      "api_vendor": "github",
      "authorization_endpoint": "https://github.com/login/device/code",
      "authorize_url": "https://github.com/login/oauth/authorize",
      "catalog_api_id": "github.com/api.github.com",
      "client_id": "Iv1.a1b2c3d4",
      "created_at": "2026-01-15T09:30:00Z",
      "created_by": "usr_6968b3987ee4c3ec0b4ee3b9",
      "default_scopes": [
        "repo",
        "read:user"
      ],
      "dependent_credential_count": 4,
      "display_name": "GitHub",
      "flow_kind": "authorization_code",
      "has_client_secret": true,
      "id": "oar_6968b39821e5f89a6975f501",
      "is_active": true,
      "name": "MyOrg GitHub",
      "secret_last_rotated_at": "2026-01-20T14:05:00Z",
      "token_endpoint": "https://github.com/login/oauth/access_token",
      "token_url": "https://github.com/login/oauth/access_token",
      "updated_at": "2026-01-20T14:05:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJ0IjogIjIwMjYtMDEtMTVUMDk6MzA6MDArMDA6MDAiLCAiaWQiOiAiM2YyYjhjMWUtN2Q0YS00ZTliLWE2YzUtMWQyZTNmNGE1YjZjIn0="
}

Changes