API Reference

Sessions

View and manage active user sessions. Useful for auditing and force-signing-out suspicious activity.

Session Object

json

{
  "id": "sess_abc123",
  "userId": "usr_abc123",
  "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)...",
  "ipAddress": "203.0.113.1",
  "country": "KR",
  "createdAt": "2026-01-15T10:30:00Z",
  "lastActiveAt": "2026-01-15T11:45:00Z",
  "expiresAt": "2026-01-16T10:30:00Z"
}

GET/v1/dashboard/sessions

List Active Sessions

List all active sessions across your project. Requires secret key.

Response

json

{
  "sessions": [
    {
      "id": "sess_abc123",
      "userId": "usr_abc123",
      "userAgent": "Chrome/120...",
      "ipAddress": "203.0.113.1",
      "lastActiveAt": "2026-01-15T11:45:00Z"
    }
  ],
  "total": 15
}

GET/v1/dashboard/users/:userId/sessions

List User Sessions

List all active sessions for a specific user.

Response

json

{ "sessions": [...], "total": 3 }

DELETE/v1/dashboard/sessions/:sessionId

Revoke Session

Force sign out a specific session. The user will be immediately signed out on that device.

Response

json

{ "success": true }

DELETE/v1/dashboard/users/:userId/sessions

Revoke All User Sessions

Force sign out all sessions for a specific user across all devices.

Response

json

{ "revoked": 3 }