Skip to main content

List Organization Tokens

List all organization member tokens (admin only).

Quick Navigation

Endpoint

GET /api/v1/organizations/{org_id}/tokens

Headers

HeaderRequiredDescription
AuthorizationYesBearer <access_token>

Path Parameters

ParameterTypeRequiredDescription
org_idintegerYesOrganization ID

Response

Success (200)

{
"success": true,
"data": {
"tokens": [
{
"id": 1,
"name": "My Org Token",
"scopes": ["read", "write"],
"organization_id": 1,
"user_id": 123,
"expires_at": "2024-04-01T12:00:00Z",
"created_at": "2024-01-01T12:00:00Z",
"last_used_at": "2024-01-15T10:30:00Z"
}
],
"total": 1,
"message": "Organization member tokens retrieved successfully"
},
"message": "Organization member tokens retrieved successfully"
}

Error (403)

{
"success": false,
"error": {
"code": "permission_denied",
"message": "Only organization administrators can view member tokens"
}
}

Features

  • Only accessible by organization administrators
  • Shows all tokens created by org members scoped to this organization
  • Token values never shown
  • Includes user_id for each token

Example

curl -X GET "https://api.rivergen.com/api/v1/organizations/1/tokens" \
-H "Authorization: Bearer <access_token>"