pctx0
from pctx0 import Pctx0Client
client = Pctx0Client(
access_key="YOUR_ACCESS_KEY",
workspace_id="YOUR_WORKSPACE_ID",
)
memories = client.memory.list("AGENT_ID", "SESSION_ID", limit=50, offset=0)import { Nctx0Client } from "@actx0/nctx0";
const client = new Nctx0Client({
accessKey: "YOUR_ACCESS_KEY",
workspaceId: "YOUR_WORKSPACE_ID",
});
const memories = await client.memory.list("AGENT_ID", "SESSION_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()
memories, err := client.Memory.List(ctx, "AGENT_ID", "SESSION_ID", 50, 0)
_ = memories
_ = err
}
curl -X GET 'https://app.actx0.com/api/v1/workspaces/<workspaceId>/agents/<agentId>/sessions/<sessionId>/memories' \
-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 memory list --agent-id AGENT_ID --session-id SESSION_ID
{
"memories": [
{
"id": "44444444-4444-4444-4444-444444444444",
"sessionId": "33333333-3333-3333-3333-333333333333",
"kind": "preference",
"content": "User prefers dark mode",
"createdAt": "2026-07-01T12:00:00Z",
"updatedAt": "2026-07-01T12:00:00Z"
}
],
"_meta": {
"limit": 50,
"offset": 0,
"total": 1
}
}{
"errorMessage": "Name is required"
}{
"errorMessage": "Name is required"
}{
"errorMessage": "Name is required"
}{
"errorMessage": "Name is required"
}Memories
List Memories
List memories in a session with pagination (limit/offset).
GET
/
workspaces
/
{workspaceId}
/
agents
/
{agentId}
/
sessions
/
{sessionId}
/
memories
pctx0
from pctx0 import Pctx0Client
client = Pctx0Client(
access_key="YOUR_ACCESS_KEY",
workspace_id="YOUR_WORKSPACE_ID",
)
memories = client.memory.list("AGENT_ID", "SESSION_ID", limit=50, offset=0)import { Nctx0Client } from "@actx0/nctx0";
const client = new Nctx0Client({
accessKey: "YOUR_ACCESS_KEY",
workspaceId: "YOUR_WORKSPACE_ID",
});
const memories = await client.memory.list("AGENT_ID", "SESSION_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()
memories, err := client.Memory.List(ctx, "AGENT_ID", "SESSION_ID", 50, 0)
_ = memories
_ = err
}
curl -X GET 'https://app.actx0.com/api/v1/workspaces/<workspaceId>/agents/<agentId>/sessions/<sessionId>/memories' \
-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 memory list --agent-id AGENT_ID --session-id SESSION_ID
{
"memories": [
{
"id": "44444444-4444-4444-4444-444444444444",
"sessionId": "33333333-3333-3333-3333-333333333333",
"kind": "preference",
"content": "User prefers dark mode",
"createdAt": "2026-07-01T12:00:00Z",
"updatedAt": "2026-07-01T12:00:00Z"
}
],
"_meta": {
"limit": 50,
"offset": 0,
"total": 1
}
}{
"errorMessage": "Name is required"
}{
"errorMessage": "Name is required"
}{
"errorMessage": "Name is required"
}{
"errorMessage": "Name is required"
}Authorizations
AccessKeyAuthApiKeyAuth
Workspace access key for agent/runtime integrations.
Path Parameters
Internal session UUID (not externalId).
Query Parameters
Page size. Defaults to 50, max 100.
Required range:
1 <= x <= 100Number of items to skip.
Required range:
x >= 0Was this page helpful?
⌘I
