Agents API

{
  "id": "agent_qP5Hz2jwHsj5oVoCPIx71",
  "userId": "user_abc123",
  "name": "Code Assistant",
  "model": "gpt-4o",
  "instructions": "You are a helpful coding assistant. Write clean, well-documented code.",
  "mcpServers": [
    {
      "type": "stdio",
      "name": "filesystem",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-filesystem", "/workspace"]
    }
  ],
  "config": {
    "temperature": 0.7,
    "maxTokens": 4096
  },
  "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",
      "model": "gpt-4o",
      "createdAt": "2025-01-15T10:30:00.000Z"
    },
    {
      "id": "agent_rQ6Ia3kxIsj6pWpDQJy82",
      "name": "Code Reviewer",
      "model": "gpt-4o-mini",
      "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": "API Builder",
    "model": "gpt-4o",
    "instructions": "You are an expert API developer. Create RESTful APIs following best practices. Use clear naming conventions and include proper error handling.",
    "config": {
      "temperature": 0.5,
      "maxTokens": 8192
    }
  }'

{
  "agent": {
    "id": "agent_sR7Jb4lyJtk7qXqERKz93",
    "userId": "user_abc123",
    "name": "API Builder",
    "model": "gpt-4o",
    "instructions": "You are an expert API developer...",
    "mcpServers": [],
    "config": {
      "temperature": 0.5,
      "maxTokens": 8192
    },
    "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": "API Builder",
    "model": "gpt-4o",
    "instructions": "You are an expert API developer...",
    "mcpServers": [],
    "config": {
      "temperature": 0.5,
      "maxTokens": 8192
    },
    "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 '{
    "model": "o1",
    "config": {
      "temperature": 0.3
    }
  }'

DELETE /v1/agents/:agentId

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

{
  "success": true
}

{
  "config": {
    "maxTokens": 4096
  }
}

{
  "config": {
    "temperature": 0.7,
    "maxTokens": 4096,
    "topP": 0.9,
    "frequencyPenalty": 0.0,
    "presencePenalty": 0.0
  }
}

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

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

curl -X POST https://api.computer-agents.com/v1/agents \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Full-Stack Assistant",
    "model": "gpt-4o",
    "instructions": "You are a full-stack developer with access to filesystem tools.",
    "mcpServers": [
      {
        "type": "stdio",
        "name": "filesystem",
        "command": "npx",
        "args": ["@modelcontextprotocol/server-filesystem", "/workspace"]
      }
    ]
  }'

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
- Include rate limiting for public endpoints

{
  "error": "Bad Request",
  "message": "Invalid model 'gpt-5'. Supported models: gpt-4o, gpt-4o-mini, o1, o1-mini, o3-mini"
}