Sessions

List all sessions

Changed on

Fetches all active sessions for the current organization.

get/v1/sessions

Request

  • Base URL
    https://api.steel.dev
  • URL
    https://api.steel.dev/v1/sessions
  • Auth
    • API key in header steel-api-key
    • or none

Query parameters

cursorIdstring

Cursor ID for pagination

limitinteger

Number of sessions to return. Default is 50, max is 100.

status'live' | 'released' | 'failed'

Filter sessions by current status

projectIdstring uuid

Filter sessions by project

Response

Response containing a list of browser sessions with pagination details.

nextCursorstring nullable required

Cursor for the next page of results. Null if no more pages.

totalCountinteger

Total number of sessions matching the query. Only included for filtered queries (e.g. status=live).

Changes

  • 8f7e74e04bd3Revision changes
    • info

      removed the ap-northeast enum value from the // response property for the response status

    • info

      removed the ap-southeast enum value from the // response property for the response status

    • info

      removed the eu-central enum value from the // response property for the response status

    • info

      removed the eu-west enum value from the // response property for the response status

    • info

      removed the fra enum value from the // response property for the response status

    • info

      removed the iad enum value from the // response property for the response status

    • info

      removed the lax enum value from the // response property for the response status

    • info

      removed the nrt enum value from the // response property for the response status

    • info

      removed the ord enum value from the // response property for the response status

    • info

      removed the sa-east enum value from the // response property for the response status

    • info

      removed the scl enum value from the // response property for the response status

    • info

      removed the us-central enum value from the // response property for the response status

    • info

      removed the us-east enum value from the // response property for the response status

    • info

      removed the us-west enum value from the // response property for the response status

    • info

      added the required property // to the response with the status

  • 416b04cf01b1Revision changes
    • info

      added the optional property // to the response with the status