Start an agent session

Start a separate managed conversation using this running sandbox's configured agent. Does not attach to its native terminal conversation. Requires agent_session.send.

Authorization

bearerAuth

AuthorizationBearer <token>

A RemoteHost API key (rh_sk_...) or a user session token.

In: header

Path Parameters

sandboxId*string

Formatuuid

Response Body

`application/json`

curl -X POST "https://example.com/sandboxes/497f6eca-6276-4993-bfeb-53cbbbba6f08/agent-sessions"

{  "id": "string",  "sessionId": "string",  "projectId": "string",  "sandboxId": "string",  "agent": "string",  "agentLabel": "string",  "communication": {    "status": "ready",    "capabilities": [      "messages"    ],    "message": "string",    "requirements": [      {        "code": "string",        "action": "restart",        "message": "string"      }    ]  },  "requirements": [    {      "code": "string",      "action": "restart",      "message": "string"    }  ],  "surface": "terminal",  "status": "active",  "turnId": "string",  "turnState": "submitted",  "needsYou": true,  "waitingOn": "string",  "pendingInput": {    "requestId": "string",    "kind": "string",    "summary": "string"  },  "error": "string",  "bridgeState": "starting",  "released": true,  "releasing": true,  "bridgeEventSeq": 0,  "drifted": true,  "problems": [    {      "seq": 0,      "event": "string",      "reason": "string"    }  ]}

Start an agent session

Authorization

Path Parameters

Response Body

201application/json

400application/json

401application/json

403application/json

404application/json

408application/json

409application/json

413application/json

500application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`