Agents API

{
  "id": "agent_qP5Hz2jwHsj5oVoCPIx71",
  "userId": "user_abc123",
  "name": "Code Assistant",
  "agentType": "llm",
  "model": "gpt-5.1",
  "instructions": "You are a helpful coding assistant. Write clean, well-documented code.",
  "mcpServers": [
    {
      "type": "stdio",
      "name": "filesystem",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-filesystem", "/workspace"]
    }
  ],
  "execution": {
    "debug": false,
    "timeout": 600000
  },
  "createdAt": "2025-01-15T10:30:00.000Z",
  "updatedAt": "2025-01-15T14:22:00.000Z"
}

GET /v1/agents

{
  "object": "list",
  "data": [
    {
      "id": "agent_qP5Hz2jwHsj5oVoCPIx71",
      "name": "Code Assistant",
      "agentType": "llm",
      "model": "gpt-5.1",
      "createdAt": "2025-01-15T10:30:00.000Z"
    },
    {
      "id": "agent_rQ6Ia3kxIsj6pWpDQJy82",
      "name": "Code Executor",
      "agentType": "computer",
      "workspace": "/projects/my-app",
      "createdAt": "2025-01-10T08:00:00.000Z"
    }
  ],
  "has_more": false,
  "total_count": 2
}

POST /v1/agents

curl -X POST https://api.computer-agents.com/v1/agents \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Code Planner",
    "model": "gpt-5.1",
    "instructions": "You are an expert software architect. Create detailed implementation plans with file structures, function signatures, and testing considerations."
  }'

curl -X POST https://api.computer-agents.com/v1/agents \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Code Executor",
    "workspace": "/projects/my-app",
    "instructions": "You are a developer. Execute code changes as requested. Write clean, well-documented code.",
    "execution": {
      "debug": true,
      "timeout": 300000
    }
  }'

{
  "agent": {
    "id": "agent_sR7Jb4lyJtk7qXqERKz93",
    "userId": "user_abc123",
    "name": "Code Planner",
    "agentType": "llm",
    "model": "gpt-5.1",
    "instructions": "You are an expert software architect...",
    "mcpServers": [],
    "createdAt": "2025-01-20T12:00:00.000Z"
  }
}

GET /v1/agents/:agentId

curl https://api.computer-agents.com/v1/agents/agent_xyz789 \
  -H "Authorization: Bearer $API_KEY"

{
  "agent": {
    "id": "agent_xyz789",
    "userId": "user_abc123",
    "name": "Code Planner",
    "agentType": "llm",
    "model": "gpt-5.1",
    "instructions": "You are an expert software architect...",
    "mcpServers": [],
    "createdAt": "2025-01-20T12:00:00.000Z"
  }
}

PATCH /v1/agents/:agentId

curl -X PATCH https://api.computer-agents.com/v1/agents/agent_xyz789 \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instructions": "You are a senior software architect with 10 years of experience..."
  }'

DELETE /v1/agents/:agentId

curl -X DELETE https://api.computer-agents.com/v1/agents/agent_xyz789 \
  -H "Authorization: Bearer $API_KEY"

{
  "success": true
}

{
  "execution": {
    "debug": false,
    "timeout": 600000
  }
}

{
  "mcpServers": [
    {
      "type": "stdio",
      "name": "filesystem",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-filesystem", "/workspace"],
      "env": {},
      "allowedTools": ["read_file", "write_file"]
    }
  ]
}

{
  "mcpServers": [
    {
      "type": "http",
      "name": "notion",
      "url": "https://notion-mcp.example.com/mcp",
      "bearerToken": "your-token",
      "headers": {}
    }
  ]
}

curl -X POST https://api.computer-agents.com/v1/agents \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Planner",
    "model": "gpt-5.1",
    "instructions": "Create implementation plans. Delegate execution to the Executor agent.",
    "handoffs": ["agent_executor_id"]
  }'

You are a Python backend developer specializing in FastAPI.

Guidelines:
- Follow PEP 8 style guidelines
- Use type hints for all function parameters and return values
- Include docstrings for all public functions
- Write unit tests for new functionality
- Use async/await for I/O operations

When creating APIs:
- Use Pydantic models for request/response validation
- Implement proper error handling with HTTPException
- Add OpenAPI documentation with examples

{
  "error": "Bad Request",
  "message": "Invalid model 'invalid-model'. Supported models: gpt-5.2, gpt-5.1, gpt-5.1-codex, gpt-5-codex, gpt-5, gpt-5-mini, gpt-5-nano"
}

{
  "error": "Validation Error",
  "message": "Either 'model' or 'workspace' must be provided"
}