AgentConnect
Sessions

List sessions

Lists CP-stored session metadata synced by daemon event/session snapshots; transcript bodies remain daemon-local. Returns one row per CONVERSATION by default (merged-conversation-view.md §5.2) — sessions sharing a thread group into conversations, each carrying its current member sessions. view=flat returns the raw sessions rows (the pre-grouped shape); conversationKey resolves one conversation’s members directly.

GET
/v1/orgs/{orgId}/sessions

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

orgId*string

Query Parameters

agentId?string|array<string>
platform?string

Value in

  • "slack"
  • "telegram"
  • "webchat"
  • "discord"
  • "feishu"
  • "hook"
  • "dream"
  • "qq"
  • "googlechat"
integration?string

Value in

  • "slack"
  • "telegram"
  • "webchat"
  • "discord"
  • "feishu"
  • "hook"
  • "dream"
  • "qq"
  • "googlechat"
  • "github"
  • "gitlab"
  • "gitea"
channel?string
triggeredBy?string
githubRepoId?string
Match^[1-9]\d*$
cursor?string
limit?integer
Range0 < value <= 200
Default50
view?string
Default"grouped"

Value in

  • "grouped"
  • "flat"
conversationKey?string
Length1 <= length <= 512
activityState?string

Value in

  • "thinking"
  • "tool_call"
  • "awaiting_permission"
  • "idle"

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/orgs/string/sessions"
{  "sessions": [    {      "sessionId": "string",      "sessionKey": {        "platform": "string",        "channel": "string",        "thread": "string"      },      "agentId": "string",      "agentName": "string",      "title": "string",      "status": "string",      "lastActivityAt": "string",      "usage": {        "reportedAt": "string",        "totalTokens": 0,        "inputTokens": 0,        "outputTokens": 0,        "thoughtTokens": 0,        "cachedReadTokens": 0,        "cachedWriteTokens": 0,        "contextUsed": 0,        "contextSize": 0,        "costAmount": 0,        "costCurrency": "string"      },      "triggeredBy": "string",      "hookKind": "webhook",      "channelName": "string",      "triggeredByName": "string",      "threadUrl": "string",      "runtime": "string",      "model": "string",      "effort": "string",      "fastMode": true,      "permissionMode": "string",      "outputMode": "string",      "daemonId": "string",      "contentSetId": "string",      "workspaceIsolation": "shared",      "visibility": "private",      "externalProvider": "string",      "externalResolution": "pending",      "contentPurgedAt": "string",      "activityState": "thinking"    }  ],  "conversations": [    {      "key": "string",      "platform": "string",      "channel": "string",      "thread": "string",      "sessions": [        {          "sessionId": "string",          "sessionKey": {            "platform": "string",            "channel": "string",            "thread": "string"          },          "agentId": "string",          "agentName": "string",          "title": "string",          "status": "string",          "lastActivityAt": "string",          "usage": {            "reportedAt": "string",            "totalTokens": 0,            "inputTokens": 0,            "outputTokens": 0,            "thoughtTokens": 0,            "cachedReadTokens": 0,            "cachedWriteTokens": 0,            "contextUsed": 0,            "contextSize": 0,            "costAmount": 0,            "costCurrency": "string"          },          "triggeredBy": "string",          "hookKind": "webhook",          "channelName": "string",          "triggeredByName": "string",          "threadUrl": "string",          "runtime": "string",          "model": "string",          "effort": "string",          "fastMode": true,          "permissionMode": "string",          "outputMode": "string",          "daemonId": "string",          "contentSetId": "string",          "workspaceIsolation": "shared",          "visibility": "private",          "externalProvider": "string",          "externalResolution": "pending",          "contentPurgedAt": "string",          "activityState": "thinking"        }      ],      "memberSessionIds": [        "string"      ]    }  ],  "total": 0,  "nextCursor": "string",  "orgHasSessions": true,  "accessSyncDegraded": true,  "accessIssues": [    {      "provider": "string",      "region": "string",      "reason": "authorization"    }  ]}