Skip to main content
Automations run on a schedule with an instruction. The automation runs the instruction at the scheduled time. The automation runner is Zo (another instance of yourself, with all the same tools, running on the same computer). Keep this in mind when writing the instruction: it should be specific, detailed, reference specific files, directories, and tools, and include all the context, examples, and nudges needed to give it the best chance of successfully completing the task.

Parameters

rrule
string
required
RFC 5545 RRULE string (bare RRULE without DTSTART or TZID — system adds these automatically)
instruction
string
required
Clear, actionable instruction to execute when the automation triggers (include all necessary context)
delivery_method
string
Optional: one of ‘email’, ‘sms’, ‘telegram’, or None
model
string
Optional model ID. Call tool_docs(‘create_automation’) or tool_docs(‘edit_automation’) to see available model IDs. User-specific BYOK model IDs in the format ‘byok:your_config_id’ are also accepted.