List Personal Access Tokens
List all personal access tokens for the authenticated user.
Endpoint
GET /api/v1/auth/tokens
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <access_token> |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
organization_id | integer | No | Filter 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>"
Related Endpoints
- Create Token - Create new token
- Revoke Token - Revoke token