Skip to main content
GET
/
session
Python
from acontext import AcontextClient

client = AcontextClient(api_key='sk_project_token')

# List sessions
sessions = client.sessions.list(
    limit=20,
    time_desc=True
)
for session in sessions.items:
    print(f"{session.id}")

# List sessions for a specific user
sessions = client.sessions.list(user='alice@acontext.io', limit=20)

# List sessions filtered by configs
sessions = client.sessions.list(
    limit=20,
    filter_by_configs={"agent": "bot1"}
)
{
  "code": 123,
  "error": "<string>",
  "msg": "<string>",
  "data": {
    "has_more": true,
    "items": [
      {
        "configs": {},
        "created_at": "<string>",
        "disable_task_tracking": true,
        "id": "<string>",
        "project_id": "<string>",
        "updated_at": "<string>",
        "user_id": "<string>"
      }
    ],
    "next_cursor": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Project Bearer token (e.g., "Bearer sk-ac-xxxx")

Query Parameters

user
string

User identifier to filter sessions

filter_by_configs
string

JSON-encoded object for JSONB containment filter. Example: {\

limit
integer

Limit of sessions to return, default 20. Max 200.

cursor
string

Cursor for pagination. Use the cursor from the previous response to get the next page.

time_desc
boolean

Order by created_at descending if true, ascending if false (default false)

Response

200 - application/json

OK

code
integer
error
string
msg
string
data
object