Smart Agent Teams
EndpointsAgents

List Agents

List the company's agents, oldest first, with month-to-date stats. Each agent includes `spend_mtd_cents` (run cost since the first of the current UTC month) and `open_tasks` (assigned tasks in `backlog`, `todo`, `in_progress`, `in_review` or `blocked`). Terminated agents are left out unless `include_terminated=true`.

GET
/api/companies/{company_id}/agents

List the company's agents, oldest first, with month-to-date stats.

Each agent includes spend_mtd_cents (run cost since the first of the current UTC month) and open_tasks (assigned tasks in backlog, todo, in_progress, in_review or blocked). Terminated agents are left out unless include_terminated=true.

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Path Parameters

company_id*Company Id
Formatuuid

Query Parameters

include_terminated?Include Terminated

Include terminated agents

Defaultfalse

Response Body

Successful Response

application/json
  1. response
[index: integer]?
curl -X GET "https://example.com/api/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/agents"
[  {    "adapter": "string",    "avatar_seed": 0,    "capabilities": [      null    ],    "company_id": "b2e6a1c3-1a5e-44ae-a8fd-81f76fd715cf",    "created_at": "2019-08-24T14:15:22Z",    "heartbeat_cron": "string",    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "instructions": "string",    "last_activity": "2019-08-24T14:15:22Z",    "monthly_budget_cents": 0,    "name": "string",    "open_tasks": 0,    "reports_to_id": "9a08cb01-6bdc-412f-ad45-35a6f5d74f8e",    "role": "string",    "spend_mtd_cents": 0,    "status": "string",    "title": "string"  }]

List Members GET

List the company's members with their name, email and role, in join order. Members only; non-members get 404 `NOT_FOUND`.

Create Agent POST

Hire an agent into the company. The agent starts `idle`. With `request_approval: true` it starts `pending_approval` instead and a `hire_agent` approval is opened; approving it makes the agent `idle`, rejecting it terminates the agent. `reports_to_id` must be an agent in this company (404 `NOT_FOUND` otherwise). `monthly_budget_cents` is in integer cents; `0` means no limit. Any member may call this. Publishes `agent.created` (and `approval.created` when an approval was opened).