.do
Resources

Agents

AI agent management

Manage AI agents via REST API.

Endpoints

List Agents

GET /:namespace/agents

Query Parameters:

  • limit (integer) - Max items (1-100, default: 10)
  • offset (integer) - Skip items (default: 0)

Response:

{
  "data": [
    {
      "id": "agent_123",
      "name": "Sales Assistant",
      "role": "sdr",
      "capabilities": ["email", "calendar", "crm"],
      "model": "gpt-5",
      "createdAt": "2024-11-11T10:00:00Z",
      "updatedAt": "2024-11-11T10:00:00Z"
    }
  ],
  "pagination": {
    "total": 25,
    "limit": 10,
    "offset": 0,
    "hasMore": true
  }
}

Get Agent

GET /:namespace/agents/:id

Create Agent

POST /:namespace/agents

Body:

{
  "name": "Sales Assistant",
  "role": "sdr",
  "capabilities": ["email", "calendar", "crm"],
  "model": "gpt-5"
}

Update Agent

PUT /:namespace/agents/:id

Body:

{
  "name": "Updated Name",
  "capabilities": ["email", "calendar", "crm", "slack"]
}

Delete Agent

DELETE /:namespace/agents/:id

SDK

import { $ } from 'sdk.do'

const client = $('acme.com')

// List
const agents = await client.Agent.list()

// Get
const agent = await client.Agent.get('agent_123')

// Create
const newAgent = await client.Agent.create({
  name: 'Sales Assistant',
  role: 'sdr',
  capabilities: ['email', 'calendar', 'crm'],
  model: 'gpt-5'
})

// Update
await client.Agent.update('agent_123', {
  capabilities: ['email', 'calendar', 'crm', 'slack']
})

// Delete
await client.Agent.delete('agent_123')