Anon Keys6

Auth Admin9

Auth Configuration25

Authentication23

Database Backups9

Database Branches7

Database Queries10

Databases10

Durable Functions22

Frontends15

Functions17

Git Connections6

Locks5

Logs3

OAuth Authentication13

OAuth Configuration6

Project Access Tokens6

Project Imports8

Projects27

Realtime3

Sandboxes24

Service Keys5

Storage Admin2

Storage Buckets5

Storage Objects9

Storage Policies3

System6

Variables5

Verified Domains3

Auth Admin

List user sessions

Changed on Oct 7, 2026

List paginated sessions for a specific auth user. Returns session details including device info, IP address, and activity timestamps.

Ordering and pagination match GET /auth/user/sessions: the default is activity order with page/limit and the legacy sessions body, and sort=created_at opts into the standard cursor/offset hybrid with the shared data envelope. Cursor pagination is only available for sort=created_at, because the activity timestamp changes under paging. The status=expired filter is offset-only because sessions can expire above a cursor anchor during a walk.

get/projects/{id}/auth/users/{userId}/sessions

Request

Base URL: https://api.volcano.dev
URL: https://api.volcano.dev/projects/{id}/auth/users/{userId}/sessions
Auth: one of:
- HTTP bearer
- HTTP bearer

Path parameters

idstring uuid required

Project ID

userIdstring uuid required

Query parameters

pageinteger

Page number (1-indexed)

limitinteger

Number of sessions per page (max 100)

sort'last_activity' | 'created_at'

Sort key. last_activity (default) orders by most recent activity and supports offset pagination only. created_at orders by session start and supports both offset and cursor pagination.

status'active' | 'expired'

Filter by whether the session can still be refreshed. Omit for every stored session, including expired ones. expired is not supported with cursor pagination.

cursorstring

Opaque keyset cursor from a previous response's next_cursor. Requires sort=created_at; mutually exclusive with page and ending_before.

ending_beforestring

Opaque keyset cursor from a previous response's prev_cursor, paging backward. Requires sort=created_at; mutually exclusive with page and cursor.

offsetinteger

Bounded number of rows to skip past the cursor anchor (the hybrid jump, maximum 100000). Ignored unless cursor or ending_before is supplied.

Response

Paginated list of user sessions

totalinteger

Total number of sessions

pageinteger

Current page number

limitinteger

Number of sessions per page

total_pagesinteger

Total number of pages

has_moreboolean

Whether a further page exists (cursor pagination only)

next_cursorstring

Opaque cursor for the next page (cursor pagination only)

prev_cursorstring

Opaque cursor for the previous page (cursor pagination only). Send as ending_before.

Example response

{
  "sessions": [
    {
      "provider": "email",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",
      "ip_address": "192.168.1.1",
      "last_ip_address": "192.168.1.100"
    }
  ],
  "data": [
    {
      "provider": "email",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",
      "ip_address": "192.168.1.1",
      "last_ip_address": "192.168.1.100"
    }
  ]
}

Changes

Oct 7, 202623e7875e7c4c Revision changes
- ○
  the endpoint scheme security ProjectAccessToken was added to the API
Sep 19, 20263a6f365f3f35 Revision changes
- ▲
  added the new path request parameter id
- ▲
  the response's body type changed from no type to object for status
- ▲
  the / response's property type changed from no type to object for status
- ▲
  the / response's property type changed from no type to object for status
- ○
  added the optional property to the response with the status
- ○
  added the optional property // to the response with the status
- ○
  added the optional property // to the response with the status
- ○
  added the optional property // to the response with the status
- ○
  added the optional property // to the response with the status
- ○
  added the optional property // to the response with the status
- ○
  added the optional property // to the response with the status
- ○
  added the optional property // to the response with the status
- ○
  added the optional property // to the response with the status
- ○
  added the optional property // to the response with the status
- ○
  added the optional property // to the response with the status
- ○
  added the optional property // to the response with the status
- ○
  added the optional property // to the response with the status
- ○
  added the optional property // to the response with the status
- ○
  added the optional property // to the response with the status
- ○
  added the required property // to the response with the status
- ○
  added the required property // to the response with the status
- ○
  added the required property // to the response with the status
- ○
  added the required property // to the response with the status
- ○
  added the required property // to the response with the status
- ○
  added the required property // to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property // to the response with the status
- ○
  added the required property // to the response with the status
- ○
  added the required property // to the response with the status
- ○
  added the required property // to the response with the status
- ○
  added the required property // to the response with the status
- ○
  added the required property // to the response with the status

Operation history (3 revisions)