Skip to main content

Endpoints

Agents​

Create Agent​

POST /v1/agents
{
  "name": "My Agent",
  "instructions": "You are a helpful assistant",
  "tools": ["web-search"],
  "model": "claude-sonnet-4-20250514"
}

List Agents​

GET /v1/agents

Get Agent​

GET /v1/agents/{agent_id}

Update Agent​

PATCH /v1/agents/{agent_id}

Delete Agent​

DELETE /v1/agents/{agent_id}

Run Agent​

POST /v1/agents/{agent_id}/run
{
  "message": "Search for the latest AI news for me",
  "stream": false
}

Stream Run Agent​

POST /v1/agents/{agent_id}/run/stream

Memory​

Store Memory​

POST /v1/memory
{
  "content": "User prefers dark theme",
  "source": "conversation",
  "tags": ["preference", "ui"]
}

Recall Memory​

POST /v1/memory/recall
{
  "query": "User's UI preferences",
  "scope": "user_preference",
  "limit": 10
}

List Memory​

GET /v1/memory

Delete Memory​

DELETE /v1/memory/{memory_id}

Tools​

Register Tool​

POST /v1/tools
{
  "name": "http-request",
  "description": "Send HTTP requests",
  "parameters": {
    "type": "object",
    "properties": {
      "url": { "type": "string" },
      "method": { "type": "string", "enum": ["GET", "POST"] }
    }
  }
}

List Tools​

GET /v1/tools

Delete Tool​

DELETE /v1/tools/{tool_name}

Chains​

Create Chain​

POST /v1/chains

Run Chain​

POST /v1/chains/{chain_id}/run

Get Chain Status​

GET /v1/chains/{chain_id}/runs/{run_id}

Webhooks​

Register Webhook​

POST /v1/webhooks
{
  "url": "https://your-server.com/webhook",
  "events": ["onComplete", "onError"],
  "agent_id": "agent_xxx"
}

List Webhooks​

GET /v1/webhooks

Delete Webhook​

DELETE /v1/webhooks/{webhook_id}

Integrations​

Connect Integration​

POST /v1/integrations/{service}

Disconnect Integration​

DELETE /v1/integrations/{service}

Sync Integration​

POST /v1/integrations/{service}/sync

Next Steps​