Smart Agent Teams
EndpointsRoutines

Create Routine

Create a routine for an agent in this company. `agent_id` and the optional `project_id` must belong to this company (404 `NOT_FOUND` otherwise). `cron` is stored as given and not validated or scheduled by this API. Publishes `routine.created`.

POST
/api/companies/{company_id}/routines

Create a routine for an agent in this company.

agent_id and the optional project_id must belong to this company (404 NOT_FOUND otherwise). cron is stored as given and not validated or scheduled by this API. Publishes routine.created.

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Path Parameters

company_id*Company Id
Formatuuid

Request Body

application/json
  1. body
agent_id*Agent Id
Formatuuid
cron*Cron
Length1 <= length <= 100
description?string|null
enabled?Enabled
Defaulttrue
project_id?|null
title*Title
Length1 <= length <= 200

Response Body

Successful Response

application/json
  1. response
agent_id*Agent Id
Formatuuid
created_at*|null
cron*Cron
description*string|null
enabled*Enabled
id*Id
Formatuuid
last_run_at*|null
project_id*|null
title*Title
curl -X POST "https://example.com/api/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/routines" \  -H "Content-Type: application/json" \  -d '{    "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",    "cron": "string",    "title": "string"  }'
{  "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",  "created_at": "2019-08-24T14:15:22Z",  "cron": "string",  "description": "string",  "enabled": true,  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "last_run_at": "2019-08-24T14:15:22Z",  "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",  "title": "string"}

List Routines GET

List the company's routines, oldest first. A routine pairs an agent with a cron schedule and a task template. Schedules are stored but not evaluated by this API; see the trigger endpoint.

Update Routine PATCH

Update a routine; only fields present in the body are changed. A new `agent_id` or `project_id` must belong to this company (404 `NOT_FOUND` otherwise). Publishes `routine.updated` when something changed.