Rensei docs
API ReferenceInteractive sessions

List interactive sessions visible to the caller.

Same auth posture as POST: session/user_token only. `?project=<slug>` or `?projectId=<id>` scopes to one project (gated by checkInteractiveAccess - an inaccessible project returns an empty list, not an error). Omitted, the list is scoped to every project the caller can see in the org (org admins see all).

GET
/api/interactive-sessions

Authorization

AuthorizationBearer <token>

Rensei API key presented as Authorization: Bearer rsk_live_. Required API-key scopes are recorded per operation in x-rensei-required-scopes.

In: header

Query Parameters

project?string

Project slug.

projectId?string

Project id. Takes priority over project when both are supplied.

Response Body

application/json

curl -X GET "https://example.com/api/interactive-sessions"
{
  "sessions": [
    {
      "id": "string",
      "sessionId": "string",
      "orgId": "string",
      "projectId": "string",
      "createdByUserId": "string",
      "status": "provisioning",
      "liveStatus": "string",
      "poolId": "string",
      "harness": "string",
      "modelProfileId": "string",
      "sandboxProvider": "string",
      "localAuthAvailable": true,
      "localAuthAvailableSource": "default",
      "displayName": "string",
      "executionLocation": {
        "provider": "string",
        "pool": {
          "id": "string",
          "displayName": "string"
        },
        "host": {
          "id": "string",
          "displayName": "string"
        },
        "sandboxFlavor": "string",
        "runtimeFlavor": "string"
      },
      "startedAt": "string",
      "endedAt": "string",
      "createdAt": "string",
      "updatedAt": "string"
    }
  ]
}
Empty
Empty
Empty