Smart Agent Teams
EndpointsAgents

Update Agent

Update an agent's profile, manager, instructions, capabilities or budget. Only fields present in the body are changed. A new `reports_to_id` must be an agent in this company and must not create a reporting cycle (400 `ORG_CYCLE`); `null` makes the agent a root of the org chart. Status is not changed here; use pause, resume and terminate. Publishes `agent.updated` when something changed.

PATCH
/api/companies/{company_id}/agents/{agent_id}

Update an agent's profile, manager, instructions, capabilities or budget.

Only fields present in the body are changed. A new reports_to_id must be an agent in this company and must not create a reporting cycle (400 ORG_CYCLE); null makes the agent a root of the org chart. Status is not changed here; use pause, resume and terminate. Publishes agent.updated when something changed.

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Path Parameters

agent_id*Agent Id
Formatuuid
company_id*Company Id
Formatuuid

Request Body

application/json
  1. body
adapter?string|null
capabilities?array<string>|null
heartbeat_cron?string|null
instructions?string|null
monthly_budget_cents?|null
name?|null
reports_to_id?|null
role?string|null
title?string|null

Response Body

Successful Response

application/json
  1. response
adapter*string|null
avatar_seed*Avatar Seed
capabilities*array<unknown>|null
company_id*|null
created_at*|null
heartbeat_cron*string|null
id*Id
Formatuuid
instructions*string|null
last_activity*|null
monthly_budget_cents*Monthly Budget Cents
name*Name
open_tasks?Open Tasks
Default0
reports_to_id*|null
role*string|null
spend_mtd_cents?Spend Mtd Cents
Default0
status*Status
title*string|null
curl -X PATCH "https://example.com/api/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{  "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"}

Get Agent GET

Get one agent with its month-to-date spend and open task count. Answers 404 `NOT_FOUND` when the agent does not belong to this company.

Pause Agent POST

Pause an agent so it is no longer woken by assignments, routines or claims. Fails with 400 `INVALID_STATE` for agents that are `terminated` or `pending_approval`. A run already in progress is not cancelled; queued runs stay queued until the agent is resumed. Publishes `agent.updated`.