sessions

List Sessions With Agent Info

Session records merged with their agent-connection metadata (CLO-434).

Joins session_records to the agent-connections registry on session_id so the cloud UI can group/filter usage by client (Claude Code, Codex, Slack, MCP, …) without a second round trip. When no registered connection matches a session, the agent type is inferred from the session_id/origin_function prefix convention (e.g. claude-code-..., codex-...).

Memory sources are intentionally omitted — per-agent dataset attribution isn’t reliably populated yet.

Response envelope mirrors GET /api/v1/sessions, with each session additionally carrying agent_type, agent_source, agent_session_name, and origin_function.

GET

api

sessions

with-agent-info

List Sessions With Agent Info

curl --request GET \
  --url https://api.cognee.ai/api/v1/sessions/with-agent-info \
  --header 'Authorization: Bearer <token>'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

range

enum<string>

default:30d

Time window filtered on last_activity_at: 24h, 7d, 30d, or all.

Available options:

24h,

7d,

30d,

all

Example:

"30d"

status

string | null

Effective-status filter: running, completed, failed, or abandoned.

limit

integer

default:50

Page size (max 500).

Required range: 1 <= x <= 500

offset

integer

default:0

Rows to skip for pagination.

Required range: x >= 0

order_by

string

default:last_activity_at

descending

boolean

default:true

Response

Successful Response

⌘I

List Sessions With Agent Info

curl --request GET \
  --url https://api.cognee.ai/api/v1/sessions/with-agent-info \
  --header 'Authorization: Bearer <token>'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Getting Started

auth

add

cognify

memify

search

permissions

datasets

ontologies

settings

visualize

schema

skills

configuration

delete

validate

update

responses

llm

sync

users

checks

health

agent management

agent connections

activity

sessions

remember

recall

improve

forget

slack

integrations

List Sessions With Agent Info

Authorizations

Query Parameters

Response