Skip to main content

List Personal Access Tokens

List all personal access tokens for the authenticated user.

Endpoint

GET /api/v1/auth/tokens

Headers

HeaderRequiredDescription
AuthorizationYesBearer <access_token>

Query Parameters

ParameterTypeRequiredDescription
organization_idintegerNoFilter by organization ID

Response

Success (200)

{
"success": true,
"data": {
"tokens": [
{
"id": 1,
"name": "My API Token",
"scopes": ["read", "write"],
"organization_id": 1,
"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": "Personal access tokens retrieved successfully"
},
"message": "Personal access tokens retrieved successfully"
}

Features

  • Shows all user's tokens (token values never shown)
  • Optional filter by organization_id
  • Shows token name, scopes, expiration, last used
  • Token values are never returned in list

Example

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