> ## Documentation Index
> Fetch the complete documentation index at: https://help.get-ryze.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Scheduled Tasks

> Have the agent run a task on a repeating schedule or once at a specific time, and email you the result — a weekly recap, a daily spend check, or a one-off reminder before a sale ends.

Set a task once and Ryze runs it on its own — either **repeating** (every day, week, or month) or **one-time** at a specific moment in the future. Each run does the work in a fresh chat and emails you the result, so the report is waiting in your inbox instead of being something you have to go pull.

One-time tasks are great for reminders and one-off checks — "pull this report tomorrow at 9am", or "check spend after the sale ends Friday". After a one-time task runs, it's marked **Completed** and won't run again.

Find it under **Schedules** in the sidebar.

<Frame>
  <img src="https://mintcdn.com/ryzeai-5f9aafd5/-c5FAIHsVxt-zgxv/images/schedules-page.png?fit=max&auto=format&n=-c5FAIHsVxt-zgxv&q=85&s=c08a967761783fa6db428279de5847db" alt="The Scheduled tasks page with saved tasks" width="3104" height="1652" data-path="images/schedules-page.png" />
</Frame>

## Create a scheduled task

Click **New task** and pick how you want to set it up.

<Frame>
  <img src="https://mintcdn.com/ryzeai-5f9aafd5/-c5FAIHsVxt-zgxv/images/schedules-new-task.png?fit=max&auto=format&n=-c5FAIHsVxt-zgxv&q=85&s=6bc2fdb7f38fd0137f87d571f66007c5" alt="The New task menu with Create with Agent and Set up manually" width="3104" height="1652" data-path="images/schedules-new-task.png" />
</Frame>

### Ask the agent

Pick **Create with Agent** and just say what you want in chat. The agent asks a couple of questions to nail down the cadence and what to report, then creates the schedule for you.

<Frame>
  <img src="https://mintcdn.com/ryzeai-5f9aafd5/-c5FAIHsVxt-zgxv/images/schedules-with-agent.png?fit=max&auto=format&n=-c5FAIHsVxt-zgxv&q=85&s=afc6f9a32bae511e88f5654253da1aa4" alt="Setting up a scheduled task by chatting with the agent" width="3104" height="1652" data-path="images/schedules-with-agent.png" />
</Frame>

It also offers this on its own — ask a question you'll clearly want answered again next week and the agent suggests a recurring task, or mention a specific moment ("check this after the sale ends Friday") and it suggests a one-time task for that time.

### Set it up manually

Pick **Set up manually** to fill in the details yourself.

<Frame>
  <img src="https://mintcdn.com/ryzeai-5f9aafd5/-c5FAIHsVxt-zgxv/images/schedules-create-dialog.png?fit=max&auto=format&n=-c5FAIHsVxt-zgxv&q=85&s=3b6a62708e48a7e1e2e7d8b462b309da" alt="The manual scheduled task creation dialog" width="3104" height="1652" data-path="images/schedules-create-dialog.png" />
</Frame>

* **Name** — what this task is, e.g. "Weekly Google Ads recap".
* **Task** — the instructions the agent runs each time. Write it like a prompt: what to check, what to report.
* **When should this run?** — choose **repeating** or **one-time**.
  * **Repeating** — daily, weekly (pick a day), or monthly (pick a date), at the time and timezone you choose.
  * **One-time** — pick a date and time (interpreted in the timezone you select). It must be in the future, and it runs exactly once.
* **Email me when each run finishes** — on by default. Turn it off if you only want the result in the chat.

New tasks are **active as soon as you create them**.

<Warning>
  Runs are billed per AI step like any agent work (see [Credits & Usage](/agent/credits)), and the agent can use every tool it has access to — including changing or deleting things in your connected accounts. Write the task carefully and use at your own risk.
</Warning>

## What happens on each run

When a schedule fires, Ryze:

1. **Starts a fresh chat** and runs your task as the agent.
2. **Writes the result** — the agent does the work and ends with a short recap: the verdict and the key numbers.
3. **Emails you** that recap (if email is on), with a link to open the full chat.

<Frame>
  <img src="https://mintcdn.com/ryzeai-5f9aafd5/-c5FAIHsVxt-zgxv/images/schedules-run-result.png?fit=max&auto=format&n=-c5FAIHsVxt-zgxv&q=85&s=27d8ca5897742906e03f2774d02bfb47" alt="A finished scheduled run with the agent's recap" width="3104" height="1652" data-path="images/schedules-run-result.png" />
</Frame>

The email is a short headline. The full reasoning and detail live in the chat behind the **View full report** link.

<Note>
  Scheduled-run chats are read-only — they're a record of what the agent did, not a conversation you continue. To change what runs, edit the task.
</Note>

## Manage a task

Open any task to see its run history, trigger it on demand, or change it.

<Frame>
  <img src="https://mintcdn.com/ryzeai-5f9aafd5/-c5FAIHsVxt-zgxv/images/schedules-detail.png?fit=max&auto=format&n=-c5FAIHsVxt-zgxv&q=85&s=9c60333cd80a61496a91fcfcd454bc79" alt="A scheduled task detail page with recent runs" width="3104" height="1652" data-path="images/schedules-detail.png" />
</Frame>

* **Run now** — fire the task immediately. For a one-time task this is a one-off extra run — it doesn't use up the scheduled time, which still fires as planned.
* **Toggle (Active / Paused)** — pause or resume a repeating schedule. Paused tasks don't run and don't bill. (One-time tasks show **Completed** once they've run.)
* **Edit / Delete** — from the menu. Deleting a task stops all future runs and removes its history.

## Related

<CardGroup cols={2}>
  <Card title="Credits" icon="coins" href="/agent/credits">
    How runs are billed.
  </Card>

  <Card title="Approvals" icon="circle-check" href="/agent/approvals">
    Improvements the agent proposes on its own.
  </Card>
</CardGroup>
