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

# Tasks

> Monitor all your agent tasks, track execution history, and view live progress of running tasks.

The Tasks tab provides a comprehensive view of all agent tasks associated with your account. Monitor active executions in real-time and review historical task data.

## Overview

The Tasks tab displays:

* All tasks you have executed
* Currently running tasks with live status updates
* Task history with execution details and results

## Task List

Your task list shows every task in reverse chronological order, with the most recent tasks at the top. Each task entry displays:

| Field         | Description                        |
| ------------- | ---------------------------------- |
| **Task ID**   | Unique identifier for the task     |
| **Prompt**    | The instruction given to the agent |
| **Device**    | The device the task ran on         |
| **Status**    | Current task state                 |
| **Duration**  | Total execution time               |
| **Timestamp** | When the task was created          |

## Task Status

Tasks progress through several states during execution:

| Status, with API value | Description                                    |
| ---------------------- | ---------------------------------------------- |
| **`queued`**           | Task is accepted and waiting for a free device |
| **`created`**          | Task record created, about to start            |
| **`running`**          | Agent is actively executing the task           |
| **`paused`**           | Execution is temporarily suspended             |
| **`cancelling`**       | A cancel request is being applied              |
| **`completed`**        | Task finished successfully                     |
| **`failed`**           | Task encountered an error and stopped          |
| **`cancelled`**        | Task was stopped before completion             |

<Tip>
  When you poll a task, treat `completed`, `failed`, and `cancelled` as the terminal states. Stop
  polling once the status is one of these three values.
</Tip>

## Live Updates

The Tasks tab updates in real-time. When a task is running:

* Status changes appear instantly
* Execution progress is visible without refreshing
* New tasks appear at the top of the list automatically

<Info>
  You do not need to refresh the page to see task updates. The interface synchronizes automatically with the server.
</Info>

## Task Details

Click on any task to view its full details:

### Execution Trajectory

The trajectory shows every action the agent took during execution:

* Screenshots at each step
* UI elements the agent interacted with
* Decisions and reasoning (when available)
* Timestamps for each action

### Task Output

For tasks with structured output schemas, view the extracted data in a formatted display. This is useful for:

* Data extraction tasks
* Verification workflows
* Automated testing results

### Error Information

For failed tasks, the details view shows:

* Error messages and stack traces
* The last successful step before failure
* Screenshots capturing the failure state

## Filtering and Search

Find specific tasks using the available filters:

| Filter         | Description                              |
| -------------- | ---------------------------------------- |
| **Status**     | Show only tasks with a specific status   |
| **Date Range** | Filter by execution date                 |
| **Device**     | Show tasks that ran on a specific device |
| **Search**     | Find tasks by prompt text or task ID     |

## Task Actions

From the task list, you can:

### View Task Stream

For running tasks, click to open the live device stream and watch the agent execute in real-time.

### Cancel Running Tasks

Stop a task that is currently in progress. The agent will halt execution and the task will be marked as cancelled.

<Info>
  The REST API endpoint for cancellation is `POST /tasks/{id}/cancel`. The TypeScript and Python SDKs name this method `client.tasks.stop(taskId)` it hits the same `/cancel` endpoint.
</Info>

### Retry Failed Tasks

Re-run a failed task with the same configuration. This creates a new task with identical parameters.