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

# Manage Tasks

> View, edit, pause, resume, delete, and review results for your scheduled tasks in ZeroTwo.

All your tasks live at `/tasks`. From here you can see what's scheduled, track running tasks, manage the full lifecycle of each task, and navigate to results in your chat history.

## The Tasks Page

Navigate to `/tasks` or click **Tasks** in the topbar. The page is organized into four tabs:

| Tab           | What it shows                                       |
| ------------- | --------------------------------------------------- |
| **Upcoming**  | Tasks scheduled and waiting for their next run time |
| **Running**   | Tasks currently executing (visible in real time)    |
| **Completed** | Tasks that have finished at least one run           |
| **Paused**    | Tasks that exist but are temporarily stopped        |

Each task card displays:

* **Task name** — derived from the first line of your task description
* **Next run time** for recurring tasks, or **scheduled time** for one-time tasks
* **Schedule type** — one-time, daily, weekly, or cron expression
* **Status indicator** — color-coded badge for current state

<Tip>
  Give tasks descriptive first lines — the first line of your task description becomes the task name shown throughout the interface. "Daily AI news briefing" is much easier to scan than "Search for the top 5..."
</Tip>

## Editing a Task

You can modify a task's description, schedule, attached files, or connected apps at any time.

<Steps>
  <Step title="Open the task">
    Click on the task card in the Tasks list. The task detail panel opens.
  </Step>

  <Step title="Click Edit">
    Click the **Edit** button in the task detail panel.
  </Step>

  <Step title="Make your changes">
    Modify any field:

    * **Description** — update the instructions or output format
    * **Schedule** — change from one-time to recurring, or adjust frequency and time
    * **Attached files** — add or remove files from your library
    * **Connectors** — add or remove connected apps
  </Step>

  <Step title="Save">
    Click **Save Changes**. The updated settings take effect on the next scheduled run.
  </Step>
</Steps>

<Note>
  Editing a recurring task does not affect runs that have already completed. Changes apply to the next scheduled run and all runs after that.
</Note>

## Pausing and Resuming Tasks

Pausing a task suspends its schedule without deleting it. The task retains all its settings and can be resumed whenever you're ready.

**To pause a task:**

1. Click the task to open its detail panel
2. Toggle the **Active/Paused** switch to the off (paused) position
3. The task moves to the **Paused** tab and will not run until resumed

**To resume a paused task:**

1. Open the **Paused** tab on the Tasks page
2. Click the task to open its detail panel
3. Toggle the **Active/Paused** switch back to on
4. The task returns to **Upcoming** with its next scheduled run time

<Tip>
  Use Pause instead of Delete when you might want to run the task again later — for example, pausing your weekly report during a vacation. Deleting is permanent; pausing preserves everything.
</Tip>

## Deleting a Task

Deleting a task permanently removes it from your Tasks list. Task results already delivered to chat history are **not affected** — they remain accessible at `/c`.

**To delete a task:**

1. Click the task to open its detail panel
2. Click the **Delete** button or the trash icon
3. Confirm the deletion in the dialog

The task is removed immediately. If it was a recurring task, no future runs will occur.

<Warning>
  Task deletion is permanent. The task configuration cannot be recovered. If you might need the task again, pause it instead.
</Warning>

## Viewing Task Results

Task results are delivered as new chats in your chat history. When a task runs:

1. ZeroTwo creates a new chat named after the task's first line
2. The task output is posted as an AI message in that chat
3. The chat is accessible at `/c` like any other conversation

**To find task results:**

* Navigate to `/c` (Chat History) and look for chats named after your task
* Use the chat history search bar to find keywords from your task output
* Open the task detail panel on `/tasks` — it links directly to the most recent result chat

## Notifications

ZeroTwo can notify you when a task completes. Enable task alerts at:

**Settings → Notifications → Task Alerts**

| Notification type | How it works                                                                                    |
| ----------------- | ----------------------------------------------------------------------------------------------- |
| **In-app**        | A badge or alert appears in ZeroTwo when the task finishes — visible next time you open the app |
| **Email**         | An email is sent to your account address with a link to the result chat                         |

<Info>
  If a task fails — for example because a connector's OAuth token expired — ZeroTwo marks it failed and sends a notification. Open the task's **View History** panel to see the failure reason and fix it.
</Info>

## Task Execution History

Each task keeps a log of every run. To review it:

1. Open the task detail panel (click the task on `/tasks`)
2. Click **View History**
3. A list of past runs appears — each shows: timestamp, status (success/failed), and a direct link to the result chat

This is useful for confirming that recurring tasks ran on schedule and for diagnosing intermittent failures.

## Quick Reference

| Action               | How                                    |
| -------------------- | -------------------------------------- |
| Create a task        | `/tasks` → New Task button             |
| Edit a task          | Click task → Edit                      |
| Pause a task         | Click task → toggle Active/Paused off  |
| Resume a task        | Paused tab → click task → toggle on    |
| Delete a task        | Click task → Delete → confirm          |
| View results         | `/c` → find the auto-named task chat   |
| Enable notifications | Settings → Notifications → Task Alerts |
| Check timezone       | Settings → General → Timezone          |