> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zocomputer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Edit automation

> Edit an existing automation's title, instruction, schedule, preferred communication channel, or model.

{/* Tool: edit_automation */}

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. delivery\_method is the user's preferred communication channel for routine messages about the run; it does not force every run to send a message. Zo emails the user if the automation fails, including when delivery\_method is None.

## Parameters

<ParamField path="automation_id" type="string" required={true}>
  The unique identifier of the automation to modify
</ParamField>

<ParamField path="title" type="string" default={""}>
  Optional. New display title for the automation. Omit to keep unchanged.
</ParamField>

<ParamField path="instruction" type="string" default={""}>
  Optional. The new instruction text to replace the existing one. Omit to keep unchanged.
</ParamField>

<ParamField path="rrule" type="string" default={""}>
  Optional. New RFC 5545 RRULE string (bare RRULE without DTSTART or TZID — system adds these automatically). Omit to keep unchanged.
</ParamField>

<ParamField path="delivery_method" type="string" default={""}>
  Optional preferred communication channel for routine messages. 'email', 'sms', 'telegram', 'slack', 'discord', or 'none' to clear. Failure alerts are emailed even when this is 'none'. Omit to keep unchanged.
</ParamField>

<ParamField path="model" type="string" default={""}>
  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.
</ParamField>

<ParamField path="active" type="string" default={""}>
  Optional. True to resume a paused task, False to pause it. Omit to keep unchanged.
</ParamField>
