Skip to main content

List OAuth Applications

List all OAuth applications for an organization.

Endpoint

GET /api/v1/organizations/{org_id}/oauth-applications

Headers

HeaderRequiredDescription
AuthorizationYesBearer <access_token>

Path Parameters

ParameterTypeRequiredDescription
org_idintegerYesOrganization ID

Query Parameters

ParameterTypeRequiredDescription
skipintegerNoNumber of records to skip (default: 0)
limitintegerNoMaximum number of records to return (default: 100)

Response

Success (200)

{
"success": true,
"data": {
"applications": [
{
"id": 1,
"name": "My OAuth App",
"description": "Application description",
"client_id": "550e8400-e29b-41d4-a716-446655440000",
"grant_types": ["authorization_code"],
"redirect_uris": ["https://myapp.com/callback"],
"scopes": ["read", "write"],
"access_level": "organization",
"status": "active",
"created_at": "2024-01-01T12:00:00Z",
"last_used_at": "2024-01-15T10:30:00Z"
}
],
"total": 1,
"message": "OAuth applications retrieved successfully"
},
"message": "OAuth applications retrieved successfully"
}

Features

  • Paginated results
  • Shows app name, client_id, access level, last used timestamps
  • Client secrets are never shown in list
  • Only accessible by organization admins

Example

curl -X GET "https://api.rivergen.com/api/v1/organizations/1/oauth-applications?skip=0&limit=10" \
-H "Authorization: Bearer <access_token>"