Projects API

Manage your agent deployments programmatically.

The Projects API allows you to create, list, and control your agents. All requests must be authenticated using a Bearer Token.

GET/api/projects

List all projects (agents) owned by the authenticated user.

Response Example
[
    {
      "id": "proj_123abc",
      "name": "My Agent",
      "status": "running",
      "plan": "starter",
      "created_at": "2026-02-14T10:00:00Z"
    }
  ]
POST/api/projects

Deploy a new agent.

Request Body
{
    "name": "TraderBot-X",
    "type": "marketplace",
    "plan": "pro",
    "telegramToken": "1234:AbCdEf...",
    "apiKey": "sk-..." 
  }
POST/api/projects/{id}/control

Send a control command to the agent container (start, stop, restart).

Request Body
{
    "action": "restart" // or "stop", "start"
  }