Actx0 REST API
Actx0 exposes a versioned HTTP API under/api/v1. Use it to run agents and sessions, store messages and memories, version prompts, and search knowledge documents.
Examples are in Pctx0 (Python), Nctx0 (Node.js), Gtcx0 (Go), and cURL / Acli. Create, list, update, and delete workspaces with a user API key (X-API-Key). Everything else in this guide uses a workspace access key (X-Access-Key).
Quick start: Create a workspace access key in the Actx0 Dashboard, then call Create Memory with
X-Access-Key.SDKs and CLI
These clients authenticate with a workspace access key (
X-Access-Key). Create workspaces and access keys in the Actx0 Dashboard.
Base URL
Authentication
Most API requests authenticate with a workspace access key:Resource hierarchy
id and/or label query params via /sessions/by-labels.
Conventions
- IDs are UUIDs.
- Timestamps are RFC3339 UTC strings.
- Pagination uses
limit(default50, max100) andoffset(default0). - List responses use a collection key plus
_meta:
metafields on messages/memories: send a JSON string in requests; responses return parsed JSON.- Errors always look like:
Core memory loop
- Create a workspace access key in the Actx0 Dashboard
- Create Agent — create an agent in the workspace
- Create Session — open a conversation session
- Create Memory — store facts and preferences
- Search Memories — retrieve relevant context
API categories
Me
Inspect the authenticated access key or API key
Workspaces
Create, list, update, and delete workspaces
Agents
Create and manage agents in a workspace
Sessions
Agent conversation sessions and labels
Messages
Session messages with semantic search
Memories
Session memory CRUD, search, and batch
Prompts
Versioned prompts and production labels
Knowledge
Document upload and semantic search
