OAuth Clients

List OAuth clients

Changed on

List all registered OAuth clients, optionally filtered by approval status.

get/admin/oauth-clients

Request

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

Query parameters

include_inactiveboolean

Whether to include inactive (disabled, pending or denied) clients; defaults to false.

Example:true
approval_statusstring nullable

Filter by approval lifecycle state: pending, approved, or denied. Filtering on pending or denied implies include_inactive=true — those rows are always inactive until approved.

Example:pending

Response

Successful Response

Example response

{
  "data": [
    {
      "active": true,
      "active_grant_count": 0,
      "allowed_scopes": [
        "agents:read",
        "credentials:read"
      ],
      "approval_status": "approved",
      "client_id": "oc_abc123...",
      "consent_model": "user",
      "created_at": "2026-08-18T12:00:00Z",
      "created_by": "usr_abc123",
      "description": "My application production deployment",
      "id": "oac_2NxYz...",
      "name": "my-app-production",
      "redirect_uris": [
        "https://app.example.com/auth/callback"
      ],
      "registration_source": "admin",
      "require_consent": true,
      "software_id": "com.example.my-app",
      "token_endpoint_auth_method": "client_secret_basic",
      "updated_at": "2026-08-18T12:00:00Z"
    }
  ]
}

Changes