AgentConnect
Agents

List an agent’s sub-sessions

Lists the background sub-sessions the agent opened, running ones first and then the most recent, at most limit (50 by default and at most). With parentSessionId it lists only those that conversation opened, newest first, a page at a time: pass a page’s nextCursor back as cursor for the next one; the conversation must be one the caller may view, and the agent’s daemon must support it (409 DAEMON_FEATURE_MISSING otherwise). Anyone who can view the agent sees each one’s state and start; its title, its session and the conversation that opened it are included only where the caller may view that conversation, and canStop says whether the caller may stop its current turn. An agent outside assistant mode is answered only when its daemon lists every agent’s sub-sessions, and 409 ASSISTANT_MODE_OFF otherwise. Nothing is stored by this call.

GET
/v1/orgs/{orgId}/agents/{id}/assistant/subsessions

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

orgId*string
id*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Query Parameters

parentSessionId?string
Length1 <= length <= 512
cursor?string
Length1 <= length <= 1024
limit?integer
Range1 <= value <= 50
Default50

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/orgs/string/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/assistant/subsessions"
{  "subsessions": [    {      "sessionId": "string",      "title": "string",      "state": "open",      "startedAt": "string",      "visible": true,      "canStop": true,      "parent": {        "sessionId": "string",        "title": "string",        "platform": "string",        "channelName": "string"      }    }  ],  "truncated": true,  "nextCursor": "string"}