Automations

Create a task automation. Provide a short imperative title, a prompt written as the user's request without scheduling details, and an iCal VEVENT schedule. Use dtstart_offset_json for relative DTSTART values. When available, pass default_timezone as the user's IANA timezone name, such as America/Los_Angeles, America/New_York, or Europe/London. If Connect, Reconnect, or approval appears, stop and wait.

Display task automations only when the user asks to view them.

List connected apps with supported automation events. Call this before discover_webhook_schema, then pass the chosen source's connector_id as connector_type. Call again after connecting or disconnecting an app.

Deliver a model-visible notification to this thread's current parent target without adding a user message to its transcript. Resolves the stored parent and follows the user's dot's handoffs to a replacement root automatically. Wakes an idle target; if a replacement root is paused, queues the notification without resuming it.

Privately look up task automations. Supply jawbone_id to inspect one task's latest recorded run and actual result. Omit it to find task IDs.

Run an existing enabled task automation once now by jawbone_id, using its saved prompt without changing its schedule. Use only when the user asks for an immediate run. Look up the task with peek if its ID is unknown. If the result contains inline_run, carry out its prompt in this turn. Dot and team tasks run in the background with their saved settings.

Create an owner-bound task for a Site.

Update an existing task automation by jawbone_id. Omitted fields keep their current values. For prompt-only updates, omit triggers to preserve existing subscriptions. Set is_enabled=false to pause the automation and is_enabled=true to resume it. When rescheduling, pass default_timezone as the user's IANA timezone name if available, such as America/Los_Angeles, America/New_York, or Europe/London.