from pctx0 import Pctx0Client

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

message = client.message.create(
    "AGENT_ID",
    "SESSION_ID",
    {"role": "user", "content": "What are my preferences?"},
)

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

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

const message = await client.message.create("AGENT_ID", "SESSION_ID", {
  role: "user",
  content: "What are my preferences?",
});

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()
	message, err := client.Message.Create(ctx, "AGENT_ID", "SESSION_ID", gctx0.MessageInput{
		Role:    gctx0.MessageRoleUser,
		Content: "What are my preferences?",
	})
	_ = message
	_ = err
}

curl -X POST 'https://app.actx0.com/api/v1/workspaces/<workspaceId>/agents/<agentId>/sessions/<sessionId>/messages' \
  -H "X-Access-Key: YOUR_ACCESS_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"role": "user", "content": "I prefer dark mode in the dashboard", "meta": "{\"source\":\"chat\"}"}'

# ---

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

acli message create "What are my preferences?" \
  --agent-id AGENT_ID \
  --session-id SESSION_ID \
  --role user

{
  "id": "55555555-5555-5555-5555-555555555555",
  "sessionId": "33333333-3333-3333-3333-333333333333",
  "role": "user",
  "content": "I prefer dark mode in the dashboard",
  "createdAt": "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"
}