Skip to main content
An automation is a Fixed hiring flow for this company: WHEN a trigger fires, IF conditions hold, THEN run the actions on branches.default. Automations are deterministic. Judgment lives in Agent chat, not in Automations. Automations do not burn Agent credits. New automations start paused. Turn one on with update_automation and status: active. Actions never send email, create offers, or book meetings. create_draft only saves a letter. A person still hits Send. Agents call the same operations on MCP.

​
Seed the starting pack

seed_automation_pack installs the default pack once per company, all paused. Call it again safely. If the pack is already installed, you get the current list.

​
List and read

  1. list_automations returns automations for this company. Filter with status (active, paused, archived) or job_id.
  2. get_automation returns one automation, including trigger, conditions, and branches.default.

​
Create an automation

create_automation needs name, trigger, and branches. Actions you can put on branches.default: set_status, set_assignee, clear_assignee, add_note, archive, restore, create_draft.

​
Update, archive, run

  1. update_automation patches only the fields you send. Pass clear_job: true to drop the job scope.
  2. archive_automation archives one automation. Run history stays.
  3. run_automation runs one automation now. Pass application_id when the flow needs an application snapshot.
  4. list_automation_runs lists recent runs. Filter with status: skipped, failed, or ran.

​
Internal tick is not public

POST /v1/internal/automations/tick is platform schedule plumbing. It is not on this hiring spec and not on MCP.