Sessions

List the key's project's sessions, newest first

Lists sessions in the API key's project (not the whole organization), ordered by created_at then id, descending. Never returns cookies.

Pitfalls:

  • The status filter is applied after the page is read, because status is derived from the clock. A page can therefore hold fewer than limit items, or none, and still carry next_cursor. Keep paging until next_cursor is absent.
  • next_cursor appears only when the unfiltered page was full. Pass it back verbatim as cursor.
get/v1/sessions

Request

  • Base URL: https://api.spicrawl.com
  • URL: https://api.spicrawl.com/v1/sessions
  • Auth: HTTP bearer

Query parameters

limitinteger

Page size. Out-of-range or non-integer values are refused with 400, not clamped.

engine'fetch' | 'js' | 'browser'

Optional. Only sessions bound to this rendering tier.

status'active' | 'released' | 'expired'

Only sessions whose clock-derived status matches. Case-insensitive. Filtered after the read; see the operation description.

cursorstring
Example:1790000000000000000.01J9ZQ4M7R3T8VX2K5N6P0B1CD

The next_cursor from the previous page, passed back verbatim. A value this API did not issue is refused with 400.

Response

One page of sessions.

next_cursorstring

Pass as cursor to get the next page. Absent when the last unfiltered page was short, which means there are no more sessions.

Example response

{
  "sessions": [
    {
      "id": "01J9ZQ4M7R3T8VX2K5N6P0B1CD"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.