workflows

Create Routine

Create a Routine: a cron that fires a Chat each occurrence, running one Master agent turn in a fresh named Chat. Use when the user asks for a standing refresh or a recurring investigation. Provide name, prompt, and cron (plus optional timezone and per-fire config like depth or an agents roster); the fire never pauses on a human and each occurrence opens a new Chat.

post/api/platform/v1/routines

Request

  • Base URL: https://docs.amdahl.ai
  • URL: https://docs.amdahl.ai/api/platform/v1/routines
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Request body

namestring required

Human label. Each fired Chat is named "{name} — {date}".

promptstring required

The Chat input every fire starts the Master turn with.

cronstring required

Cron expression (e.g. "0 9 * * 1"). Validated before the row is stored.

timezonestring

IANA timezone the cron evaluates in. Defaults to UTC.

agentstring

LEGACY single-agent pin the Master turn runs as (library slug/uuid or workspace agent id/slug). Prefer config.agents; passing both rejects.

enabledboolean

Whether the routine fires. Defaults to true.

Response

Created

dataunknown

Changes

No recorded changes to this operation across all 1 revision of this API.