Smart Agent Teams
EndpointsAgents

Resume Agent

Resume a paused agent, setting it back to `idle`. Only `paused` agents can be resumed (400 `INVALID_STATE` otherwise). Resuming does not decide a pending `budget_override` approval, and an agent still over its budget is paused again when its next run finishes. Publishes `agent.updated`.

POST
/api/companies/{company_id}/agents/{agent_id}/resume

Resume a paused agent, setting it back to idle.

Only paused agents can be resumed (400 INVALID_STATE otherwise). Resuming does not decide a pending budget_override approval, and an agent still over its budget is paused again when its next run finishes. Publishes agent.updated.

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Path Parameters

agent_id*Agent Id
Formatuuid
company_id*Company Id
Formatuuid

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 POST "https://example.com/api/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/resume"
{  "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"}

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`.

Terminate Agent POST

Terminate an agent (soft delete): it leaves the org chart but its history stays. The agent's direct reports move to the agent's own manager (or become roots), and its `queued` and `running` runs are cancelled with the error "Agent terminated". Assigned tasks and routines are left unchanged. Publishes `agent.updated` and `run.updated` for each cancelled run.