from pctx0 import Pctx0Client

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

memories = client.memory.create(
    "AGENT_ID",
    "SESSION_ID",
    [
        {"kind": "fact", "content": "Uses TypeScript"},
        {"kind": "preference", "content": "Prefers dark mode"},
    ],
)

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

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

const memories = await client.memory.create("AGENT_ID", "SESSION_ID", [
  { kind: "fact", content: "Uses TypeScript" },
  { kind: "preference", content: "Prefers dark mode" },
]);

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.CreateBatch(ctx, "AGENT_ID", "SESSION_ID", []gctx0.MemoryInput{
		{Kind: gctx0.MemoryKindFact, Content: "Uses TypeScript"},
		{Kind: gctx0.MemoryKindPreference, Content: "Prefers dark mode"},
	})
	_ = memories
	_ = err
}

curl -X POST 'https://app.actx0.com/api/v1/workspaces/<workspaceId>/agents/<agentId>/sessions/<sessionId>/memories/batch' \
  -H "X-Access-Key: YOUR_ACCESS_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"memories": [{"kind": "preference", "content": "User prefers dark mode"}, {"kind": "fact", "content": "User is on the Pro plan"}]}'

{
  "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": "<unknown>"
    }
  ]
}

{
  "errorMessage": "Name is required"
}

{
  "errorMessage": "Name is required"
}

{
  "errorMessage": "Name is required"
}

{
  "errorMessage": "Name is required"
}

{
  "errorMessage": "Name is required"
}