Create Thread

POST

api

threads

curl -X POST https://your-worker.workers.dev/api/threads \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "support_agent",
    "user_id": "user_abc123",
    "tags": ["support", "web"]
  }'

const response = await fetch('https://your-worker.workers.dev/api/threads', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    agent_id: 'support_agent',
    user_id: 'user_abc123',
    tags: ['support', 'web']
  })
});
const thread = await response.json();

{
  "threadId": "550e8400-e29b-41d4-a716-446655440000",
  "agent_id": "support_agent",
  "message": "Thread created successfully"
}

Creates a new conversation thread with the specified agent.

string

required

The name of the agent to use for this thread. Must match an agent defined in agents/agents/.

string

Optional user identifier for tracking and authorization.

array

Optional array of string tags for categorizing and filtering threads.

string

required

Unique thread identifier (UUID)

string

required

The agent name associated with this thread

string

required

Confirmation message

curl -X POST https://your-worker.workers.dev/api/threads \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "support_agent",
    "user_id": "user_abc123",
    "tags": ["support", "web"]
  }'

const response = await fetch('https://your-worker.workers.dev/api/threads', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    agent_id: 'support_agent',
    user_id: 'user_abc123',
    tags: ['support', 'web']
  })
});
const thread = await response.json();

{
  "threadId": "550e8400-e29b-41d4-a716-446655440000",
  "agent_id": "support_agent",
  "message": "Thread created successfully"
}

curl -X POST https://your-worker.workers.dev/api/threads \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "support_agent",
    "user_id": "user_abc123",
    "tags": ["support", "web"]
  }'

const response = await fetch('https://your-worker.workers.dev/api/threads', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    agent_id: 'support_agent',
    user_id: 'user_abc123',
    tags: ['support', 'web']
  })
});
const thread = await response.json();

{
  "threadId": "550e8400-e29b-41d4-a716-446655440000",
  "agent_id": "support_agent",
  "message": "Thread created successfully"
}

Threads

Messages

File System

Define Utilities

WebSocket