pctx0
from pctx0 import Pctx0Client
client = Pctx0Client(
access_key="YOUR_ACCESS_KEY",
workspace_id="YOUR_WORKSPACE_ID",
)
messages = client.message.create(
"AGENT_ID",
"SESSION_ID",
[
{"role": "user", "content": "Hello"},
{"role": "assistant", "content": "Hi there"},
],
)import { Nctx0Client } from "@actx0/nctx0";
const client = new Nctx0Client({
accessKey: "YOUR_ACCESS_KEY",
workspaceId: "YOUR_WORKSPACE_ID",
});
const messages = await client.message.create("AGENT_ID", "SESSION_ID", [
{ role: "user", content: "Hello" },
{ role: "assistant", content: "Hi there" },
]);
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()
messages, err := client.Message.CreateBatch(ctx, "AGENT_ID", "SESSION_ID", []gctx0.MessageInput{
{Role: gctx0.MessageRoleUser, Content: "Hello"},
{Role: gctx0.MessageRoleAssistant, Content: "Hi there"},
})
_ = messages
_ = err
}
curl -X POST 'https://app.actx0.com/api/v1/workspaces/<workspaceId>/agents/<agentId>/sessions/<sessionId>/messages/batch' \
-H "X-Access-Key: YOUR_ACCESS_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"messages": [{"role": "user", "content": "Hello"}, {"role": "assistant", "content": "Hi there"}]}'
{
"messages": [
{
"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"
}Messages
Batch Create Messages
Create up to 100 session messages in one request.
POST
/
workspaces
/
{workspaceId}
/
agents
/
{agentId}
/
sessions
/
{sessionId}
/
messages
/
batch
pctx0
from pctx0 import Pctx0Client
client = Pctx0Client(
access_key="YOUR_ACCESS_KEY",
workspace_id="YOUR_WORKSPACE_ID",
)
messages = client.message.create(
"AGENT_ID",
"SESSION_ID",
[
{"role": "user", "content": "Hello"},
{"role": "assistant", "content": "Hi there"},
],
)import { Nctx0Client } from "@actx0/nctx0";
const client = new Nctx0Client({
accessKey: "YOUR_ACCESS_KEY",
workspaceId: "YOUR_WORKSPACE_ID",
});
const messages = await client.message.create("AGENT_ID", "SESSION_ID", [
{ role: "user", content: "Hello" },
{ role: "assistant", content: "Hi there" },
]);
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()
messages, err := client.Message.CreateBatch(ctx, "AGENT_ID", "SESSION_ID", []gctx0.MessageInput{
{Role: gctx0.MessageRoleUser, Content: "Hello"},
{Role: gctx0.MessageRoleAssistant, Content: "Hi there"},
})
_ = messages
_ = err
}
curl -X POST 'https://app.actx0.com/api/v1/workspaces/<workspaceId>/agents/<agentId>/sessions/<sessionId>/messages/batch' \
-H "X-Access-Key: YOUR_ACCESS_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"messages": [{"role": "user", "content": "Hello"}, {"role": "assistant", "content": "Hi there"}]}'
{
"messages": [
{
"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"
}Authorizations
AccessKeyAuthApiKeyAuth
Workspace access key for agent/runtime integrations.
Path Parameters
Internal session UUID (not externalId).
Body
application/json
Required array length:
1 - 100 elementsShow child attributes
Show child attributes
Response
Created
Show child attributes
Show child attributes
Was this page helpful?
⌘I
