from pctx0 import Pctx0Client

client = Pctx0Client(
    access_key="YOUR_ACCESS_KEY",
    workspace_id="YOUR_WORKSPACE_ID",
)

sessions = client.session.list("AGENT_ID", limit=50, offset=0)

import { Nctx0Client } from "@actx0/nctx0";

const client = new Nctx0Client({
  accessKey: "YOUR_ACCESS_KEY",
  workspaceId: "YOUR_WORKSPACE_ID",
});

const sessions = await client.session.list("AGENT_ID", { limit: 50, offset: 0 });

package main

import (
	"context"

	"github.com/Actx0/Gctx0"
)

func main() {
	client := gctx0.NewClient(
		gctx0.WithAccessKey("YOUR_ACCESS_KEY"),
		gctx0.WithWorkspaceId("YOUR_WORKSPACE_ID"),
	)
	defer client.Close()
	ctx := context.Background()
	sessions, err := client.Session.List(ctx, "AGENT_ID", gctx0.SessionLookup{}, 50, 0)
	_ = sessions
	_ = err
}

curl -X GET 'https://app.actx0.com/api/v1/workspaces/<workspaceId>/agents/<agentId>/sessions' \
  -H "X-Access-Key: YOUR_ACCESS_KEY" \
  -H "Accept: application/json"

# ---

# acli
export ACTX0_ACCESS_KEY="YOUR_ACCESS_KEY"
export ACTX0_WORKSPACE_ID="YOUR_WORKSPACE_ID"

acli session list --agent-id AGENT_ID

{
  "sessions": [
    {
      "id": "33333333-3333-3333-3333-333333333333",
      "externalId": "ticket-4821",
      "workspaceId": "11111111-1111-1111-1111-111111111111",
      "agentId": "22222222-2222-2222-2222-222222222222",
      "status": "active",
      "createdAt": "2026-07-01T12:00:00Z",
      "updatedAt": "2026-07-01T12:00:00Z",
      "title": "Ticket #4821",
      "labels": {
        "userId": "alice",
        "channel": "web"
      },
      "meta": "<unknown>",
      "lastActivityAt": "2026-07-01T12:00:00Z"
    }
  ],
  "_meta": {
    "limit": 50,
    "offset": 0,
    "total": 12
  }
}

{
  "errorMessage": "Name is required"
}

{
  "errorMessage": "Name is required"
}

{
  "errorMessage": "Name is required"
}

{
  "errorMessage": "Name is required"
}

{
  "errorMessage": "Name is required"
}