Rensei docs
API ReferenceInteractive sessions

List revision-pinned interactive-session launch choices for a project.

Human-only, project-authorized, redacted picker DTO for model profiles, profile-derived harnesses, capacity pools, repositories, and saved Agent Cards. Secret credentials, endpoint material, and raw resource configuration are never returned. The project must belong to the org resolved from the caller's auth context (default org, or an explicit org-selection header) - a projectId belonging to a different org 404s rather than being silently evaluated against the wrong org's profile/pool set.

GET
/api/projects/{projectId}/interactive-session-launch-options

Authorization

headerAuthorizationBearer <WorkOS user access token>

WorkOS user access token created by the Rensei CLI. The authenticated organization is resolved from membership and may be narrowed with X-Rensei-Org.

Path Parameters

projectId*string

Response Body

Authorized launch options and current revision-pinned defaults.

application/json
  1. response
pools*array<>
harnesses*array<>
modelProfiles*array<>
repositories*array<>
agentCards*array<>
defaults*
connectionInventory*
compositionInventory*
Example Request
curl -X GET 'https://app.rensei.ai/api/projects/string/interactive-session-launch-options'
Example Response
{  "pools": [    {      "ref": {        "id": "string",        "revision": "string"      },      "label": "string",      "description": "string",      "status": "available",      "reason": "string",      "viability": {        "reason": "admission_pending",        "chip": "string",        "detail": "string",        "advisory": true      },      "meta": {        "property1": "string",        "property2": "string"      }    }  ],  "harnesses": [    {      "ref": {        "id": "string",        "revision": "string"      },      "label": "string",      "description": "string",      "status": "available",      "reason": "string",      "viability": {        "reason": "admission_pending",        "chip": "string",        "detail": "string",        "advisory": true      },      "meta": {        "property1": "string",        "property2": "string"      }    }  ],  "modelProfiles": [    {      "ref": {        "id": "string",        "revision": "string"      },      "label": "string",      "description": "string",      "status": "available",      "reason": "string",      "viability": {        "reason": "admission_pending",        "chip": "string",        "detail": "string",        "advisory": true      },      "meta": {        "property1": "string",        "property2": "string"      }    }  ],  "repositories": [    {      "ref": {        "id": "string",        "revision": "string"      },      "label": "string",      "description": "string",      "status": "available",      "reason": "string",      "viability": {        "reason": "admission_pending",        "chip": "string",        "detail": "string",        "advisory": true      },      "meta": {        "property1": "string",        "property2": "string"      }    }  ],  "agentCards": [    {      "ref": {        "id": "string",        "revision": "string"      },      "label": "string",      "description": "string",      "status": "available",      "reason": "string",      "viability": {        "reason": "admission_pending",        "chip": "string",        "detail": "string",        "advisory": true      },      "meta": {        "property1": "string",        "property2": "string"      }    }  ],  "defaults": {    "pool": {      "id": "string",      "revision": "string"    },    "harness": {      "id": "string",      "revision": "string"    },    "modelProfile": {      "id": "string",      "revision": "string"    },    "repository": {      "id": "string",      "revision": "string"    }  },  "connectionInventory": {    "status": "profile-derived-only",    "message": "string"  },  "compositionInventory": {    "status": "agent-card-definition-only",    "message": "string"  }}

Mint a short-lived relay attach token (driver/viewer for users; host for the provisioning daemon) for an interactive session.

USER mint (role driver/viewer or omitted): authentication accepts a browser session or a WorkOS user token only; an rsk API key or a BYOA OAuth-agent token is rejected 403 (no user identity to derive a role from). The minted role is a server-derived ceiling, never a client-claimed value. HOST mint (role "host"): accepts ONLY a worker-class machine identity - a plain org rsk_ API key or a worker runtime JWT - acting within the session's org; human identities, OAuth-agent tokens, and registration-bound keys are rejected 403. The host response carries the daemon wire contract { attachUrl, token, epoch, expiresAt } with a freshly allocated host stream epoch. HOST refresh (role "host-refresh", requires epoch): same caller gate as "host"; re-signs a token for the CURRENT host generation WITHOUT allocating a new epoch - the reconnect-after-expiry re-mint rail. A presented epoch that no longer matches the live generation is refused 409 (epoch_stale).

List model catalog identities available for org adoption.

List model catalog identities available for org adoption. - Rensei REST API operation reference.