OIP system: Automation
Automation
A generated article for one OIP shelf. It lists every operation in this API/CLI/MCP/device/model/core subsystem, links each leaf article, and gives the ledger path for proof.
This page is the operating article for one build subsystem. It is generated from live directory rows. If a task belongs to this subsystem, scan the operations below, open the matching capability article, run only the exact object named there, and verify by receipt.
Kind: core. Capabilities: 6. Machine system map: /api/dispatch?map=AUTOMATE&format=markdown. Root: /a/oip.
Operations
AUTOMATE_ADD
Automate a capability — make it fire itself every N minutes and ledger a receipt each run. Turns a one-off action into a standing background job. Use when: "automate this", "do this every morning/hour", "keep doing X", "run this on a schedule". Arguments: name | every_minutes | KEY | body (body is whatever that KEY takes; may contain pipes). Human article: /a/oip-capability-automate-add. Machine doc: ?key=AUTOMATE_ADD&format=markdown. Invocation history: /api/invocations?object_id=AUTOMATE_ADD.
AUTOMATE_LIST
List every automation — id, name, schedule, target key, enabled, last run, run count. Use when: "what's automated", "list my automations", "what runs on a schedule". Arguments: none. Human article: /a/oip-capability-automate-list. Machine doc: ?key=AUTOMATE_LIST&format=markdown. Invocation history: /api/invocations?object_id=AUTOMATE_LIST.
AUTOMATE_TOGGLE
Turn an automation on or off by id (paused, not deleted). Use when: "pause that automation", "turn it back on", "stop the morning ping". Arguments: id | 1|0. Human article: /a/oip-capability-automate-toggle. Machine doc: ?key=AUTOMATE_TOGGLE&format=markdown. Invocation history: /api/invocations?object_id=AUTOMATE_TOGGLE.
AUTOMATE_DELETE
Delete an automation by id. Use when: "remove that automation", "delete the scheduled job". Arguments: id. Human article: /a/oip-capability-automate-delete. Machine doc: ?key=AUTOMATE_DELETE&format=markdown. Invocation history: /api/invocations?object_id=AUTOMATE_DELETE.
AUTOMATE_RUN_DUE
Fire every enabled automation whose interval has elapsed; ledger a receipt for each. Called by the cron each tick; safe to call manually. Use when: "run due automations now", or the cron calls it automatically. Arguments: none. Human article: /a/oip-capability-automate-run-due. Machine doc: ?key=AUTOMATE_RUN_DUE&format=markdown. Invocation history: /api/invocations?object_id=AUTOMATE_RUN_DUE.
AUTOMATE_FIRE
Fire every enabled automation registered for an event (trigger=event:NAME). Any inbound hook (a customer text, an error, a webhook) calls this with the event name + payload; matching automations run and ledger a receipt. Use when: an event source (webhook, hook, cron) signals something happened — "when a customer text arrives", "on error", "on new order". Arguments: event_name | payload (payload is passed to each automation whose body is empty). Human article: /a/oip-capability-automate-fire. Machine doc: ?key=AUTOMATE_FIRE&format=markdown. Invocation history: /api/invocations?object_id=AUTOMATE_FIRE.