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

# How to start, follow, and approve mission runs

> Start runs by hand or from a file, follow every step on the run page, approve or edit what the agent wants to do, and tell it what it needs to know.

A run is one mission working with one person, or with everyone at one company. Open a mission to see its runs.

## The Runs tab

![The Runs tab](https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/runs-tab.png?fit=max\&auto=format\&n=J9oopG46WMTX3-j2\&q=85\&s=86f9ffb3b72163e35e4df4c09c2e4d42)

The cards at the top count open runs, runs that need you, goals reached, and credits used this month.

Each row shows the person, the run's status, its last and next step, how many messages it sent, and which day of the run it's on. Test runs have a **Test** tag. You can search, or filter to open runs, runs that need you, goals reached, or stopped and failed runs.

| Status | Meaning |
| - | - |
| **Needs you** | Waiting for your approval or answer. |
| **Working** | The agent is on it now. |
| **Scheduled** | The agent checks in again later. |
| **Waiting on teammate** | A Linear task it created is still open. |
| **On hold** | A rule held it. The reason shows under the status. |
| **Paused** | You paused it, or it ran out of credits. |
| **Goal reached**, **Failed**, **Stopped** | It ended. |

## Start runs by hand

Click **Start a run** on a live mission.

### One person

![Start a run for one person](https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-run-one-person.png?fit=max\&auto=format\&n=J9oopG46WMTX3-j2\&q=85\&s=afec37bd7cd31ba01ec5a2f77b1e86b9)

Enter their email. Add a brief if the agent should do something first, like "Check their open tickets first". Click **Start run**.

### From a file

![Start runs from a file](https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-run-upload.png?fit=max\&auto=format\&n=J9oopG46WMTX3-j2\&q=85\&s=c5bcfa9f83f6d01ceb0cd8e044dd1266)

Upload a CSV or Excel file, up to 5 MB and 1,000 rows, with an email column. Name, phone, company, and attributes are optional. **Download CSV template** gives you an example.

Match your columns, then click **Start runs**. A message tells you how many runs started and who was skipped and why, such as no email or already in a run.

> [!NOTE]
>
> A person can only be in one open run at a time, across all missions on the AI agent.

### From Contacts

In **Contacts**, select people and click **Start mission**.

![Contacts selected, with Start mission](https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/contacts-start-mission.png?fit=max\&auto=format\&n=J9oopG46WMTX3-j2\&q=85\&s=3d242b75da111dd9578bf32f90b7180c)

Pick a live mission and confirm. You can start up to 1,000 people at once.

![The Start a mission dialog](https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-mission-dialog.png?fit=max\&auto=format\&n=J9oopG46WMTX3-j2\&q=85\&s=43a7814a00821ed46327a8edd1a5f7ee)

## The run page

Click a run to open it. The timeline lists every step, newest at the bottom. The **Details** panel on the right shows the person, the goal, the dates, and this week's messages.

![A run page](https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/run-page.png?fit=max\&auto=format\&n=J9oopG46WMTX3-j2\&q=85\&s=93e54d571835e898bb2925bb20f12118)

### The timeline

Click any step to see more.

| Step | Shows |
| - | - |
| **Run started** | How it started: a rule, by hand, or a test. |
| **Email to…**, **WhatsApp to…**, **Call to…** | The message, or the call summary with a link to the recording. |
| **… replied by email** | The reply, and whether it woke the agent and why. |
| **Approval: …** | An action waiting for you, or what you decided. |
| **Question from the agent** | Its question and your answer. |
| **On hold: …** | A message a guardrail held. |
| **Reached: …** | A milestone. |
| **Agent worked · N steps** | Background work, like reading conversations and updating the plan. |
| **Run ended** | Goal reached, failed, or stopped, with the reason. |

### When a run needs you

A bar above the message box shows what's waiting. Click **Review** or **Answer**.

![A run waiting for an answer](https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/run-needs-you.png?fit=max\&auto=format\&n=J9oopG46WMTX3-j2\&q=85\&s=54e518f85f0f0b29e84f4fc67d9ebf44)

For an approval, you can approve it, **Edit** it first, or **Skip** it. Editing lets you change an email's subject and message, or a WhatsApp message, then **Save and send**. If you skip, the agent picks another step.

For a question, click an answer or type your own. After 3 days with no answer, the agent decides itself.

### Tell the agent

Type in the box at the bottom to tell the agent something, like "She's away until Monday". It reads it right away.

### Log an event

Click **Log an event** when something happened that Chatbase didn't see.

![The Log an event dialog](https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/log-event.png?fit=max\&auto=format\&n=J9oopG46WMTX3-j2\&q=85\&s=45e35189169f791e392112614ec778e9)

Pick what happened, such as a booked call or a reply somewhere else, or write a custom event. Add details, then choose to wake the agent now, just add it to what the agent knows, or end the run as a success.

### Pause, stop, or end a run

**Pause run** stops the agent on this run until you resume it. The **⋯** menu can also:

* **Stop run**, so the agent never contacts them again in this mission. You can start a new run later.
* **Mark goal reached**, with the outcome they reached.
* **Mark as failed**, with a short reason.

### The Details panel

* The **Run actions without approval** switch here changes the whole mission, not just this run. [Approvals](https://chatbase.co/docs/user-guides/missions/configure-a-mission.md#approvals) explains it.
* **People** lists everyone on the run and whether they've been contacted. You can pause missions for one person, or for their whole company. Replies still reach your AI agent.
* **Plan** shows the steps the agent plans next.
* **Memory** shows facts the agent saved about the account.

### Failed steps

If a step fails, like an email that couldn't send, the timeline shows the error and a **Retry** button. Some steps retry on their own.

When a run ends, click **Start a new run** to try again with the same person.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.