Smart Agent Teams
EndpointsInsights

List Activity

List the company's audit trail, newest first. Every mutation is recorded with its actor (member, agent or system), verb, entity and changed fields. Filter by `entity_type` and `entity_id`, and page with `before` (the `created_at` of the last row seen) and `limit` (default 50, max 200).

GET
/api/companies/{company_id}/activity

List the company's audit trail, newest first.

Every mutation is recorded with its actor (member, agent or system), verb, entity and changed fields. Filter by entity_type and entity_id, and page with before (the created_at of the last row seen) and limit (default 50, max 200).

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Path Parameters

company_id*Company Id
Formatuuid

Query Parameters

entity_type?|

Only events for this entity type, e.g. task

entity_id?|

Only events for this entity id

before?|

Cursor: created_at of the last row seen

limit?Limit

Maximum number of events to return

Range1 <= value <= 200
Default50

Response Body

Successful Response

application/json
  1. response
[index: integer]?
curl -X GET "https://example.com/api/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/activity"
[  {    "actor_id": "string",    "actor_name": "string",    "actor_type": "string",    "changes": {},    "created_at": "2019-08-24T14:15:22Z",    "entity_id": "string",    "entity_label": "string",    "entity_type": "string",    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "verb": "string"  }]

Trigger Routine POST

Run a routine now: create its task for the agent and queue a `routine` run. The task is created as `todo` with `medium` priority, assigned to the routine's agent and project. Fails with 400 `INVALID_STATE` when the agent is `paused`, `pending_approval` or `terminated`. Cron schedules are stored but not evaluated by this API yet; a scheduler calls this endpoint (or a person does, from the UI). Publishes `task.created`, `run.created` and `routine.updated`.

Get Costs GET

Get spend for one calendar month, by agent and by project. `month` is `YYYY-MM` (default: the current UTC month). Amounts are integer cents; a budget of `0` means no limit. Each line also has run and token counts. Terminated agents appear only if they have spend that month; runs without a project are grouped under "No project" with `id: null`. Lines are sorted by spend, highest first.