Endpoint
Authentication
Pass one ofAuthorization: Bearer <api-key> or Authorization: ApiKey <key>.
Path Parameters
string
required
The agent session identifier.
Response
string
Always
list.array
Array of subagent objects.
curl https://agent.example.com/v1/agents/sessions/sess_01J5X8/subagents \
-H "Authorization: Bearer <api-key>"
{
"object": "list",
"data": [
{
"id": "sub_01D",
"session_id": "sess_01J5X8",
"status": "active",
"created_at": "2024-06-01T12:35:00Z"
}
]
}
Memory & Subagents
List Subagents
Retrieve all subagents launched within an agent session. Each subagent is an independent child agent with its own message history.
curl https://agent.example.com/v1/agents/sessions/sess_01J5X8/subagents \
-H "Authorization: Bearer <api-key>"
{
"object": "list",
"data": [
{
"id": "sub_01D",
"session_id": "sess_01J5X8",
"status": "active",
"created_at": "2024-06-01T12:35:00Z"
}
]
}
Subagents are child agents spawned within a session. This endpoint lists every subagent, letting you inspect which child agents are active or completed inside the parent session.
Was this page helpful?