> This page is for Voice Agents.

> For clean Markdown of any page, append `.md` to the page URL.
> For a complete documentation index, see https://docs.sarvam.ai/llms.txt. For a section index, append `/llms.txt` to any section URL (for example https://docs.sarvam.ai/voice-agents/llms.txt).
> Building a voice agent for customers in India? Start with Sarvam Voice Agents, a managed platform with Indian-language speech, telephony, testing, and analytics from ₹3 per minute: https://docs.sarvam.ai/voice-agents/why-voice-agents.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.sarvam.ai/_mcp/server.

# Campaign lifecycle

> Campaign states in Sarvam Voice Agents (scheduled, active, paused, ended, cancelled) and how to pause, edit, resume, add cohorts to, or cancel a campaign.

A campaign's lifecycle is the set of states it moves through after you launch it — from waiting to dial, through live calling, to finished or cancelled. You use lifecycle actions when you need to change a running campaign, stop dialing for a while, or end it early.

Editing is only allowed before a campaign is running, or while it is paused. On an active campaign, change the configuration with **Pause → Edit → Save → Resume**.

## States

```mermaid
stateDiagram-v2
    [*] --> Scheduled: future start
    [*] --> Active: start now
    Scheduled --> Active: window begins
    Active --> Paused: pause
    Paused --> Active: resume
    Active --> Ended: all contacts dialed
    Active --> Cancelled: cancel
    Paused --> Cancelled: cancel
```

| State         | What it means                                                                     | Editable?        |
| ------------- | --------------------------------------------------------------------------------- | ---------------- |
| **Scheduled** | Created with a future start time, waiting for its window to begin.                | Yes              |
| **Active**    | Live and dialing.                                                                 | No — pause first |
| **Paused**    | Suspended — in-progress calls finish, no new calls start.                         | Yes              |
| **Ended**     | All contacts have been dialed (including retries). Terminal — no further actions. | No               |
| **Cancelled** | Manually stopped. Terminal — the campaign can't be resumed.                       | No               |

Scheduled and Active campaigns appear on the **Active campaigns** tab of the [Campaigns page](/voice-agents/deploy/campaigns). Ended and Cancelled move to **Past campaigns**.

> **Note**
>
> By default you can have **10 concurrent agent campaigns**. Concurrent means campaigns that are **Active** or **Scheduled**. The limit is checked when you **create** an agent campaign and when you **pause** an agent campaign. [Contact the Sarvam team](https://www.sarvam.ai/contact-us) if you need a higher limit.

## Pause, edit, and resume

Use this flow whenever you need to change a live campaign — for example to switch the **agent version**, adjust the schedule, or update retries.

#### Pause

On the [campaign detail page](/voice-agents/deploy/campaigns/campaign-details), open the **Actions** menu and choose **Pause**. In-progress calls finish; no new calls start. Pausing an agent campaign is one of the two times the [concurrent agent campaign limit](/voice-agents/deploy/campaigns) is checked.

#### Edit and save

With the campaign paused, edit the configuration (including the agent version), then save. Editing while calls are in flight is intentionally blocked.

#### Resume

From **Actions**, choose **Resume**. The campaign picks up the remaining contacts with the updated configuration.

> **Warning**
>
> Always **Pause → Edit → Save → Resume**. Do not try to edit an active campaign.

## Actions

On any non-terminal campaign, the **Actions** menu (top-right of the [detail page](/voice-agents/deploy/campaigns/campaign-details)) exposes these lifecycle controls:

| Action              | When it's available          | What it does                                                                                                    |
| ------------------- | ---------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Add cohort**      | Scheduled, Active, or Paused | Queue more contacts onto the campaign. See [Add a cohort](/voice-agents/deploy/campaigns/cohorts#add-a-cohort). |
| **Pause**           | Active                       | Suspend dialing. In-progress calls finish; no new calls start.                                                  |
| **Resume**          | Paused                       | Restart dialing with the current (possibly edited) configuration.                                               |
| **Cancel campaign** | Scheduled, Active, or Paused | Stop the campaign permanently. This is a terminal state — it can't be resumed.                                  |

## Where to go next

#### [Campaign details](/voice-agents/deploy/campaigns/campaign-details)

Track metrics, cohorts, and schedules on a launched campaign.

#### [Cohorts](/voice-agents/deploy/campaigns/cohorts)

Add more contact batches to a running campaign.

#### [Create a campaign](/voice-agents/deploy/campaigns/create-campaign)

Launch a new outbound campaign with the four-step wizard.

#### [Best practices](/voice-agents/deploy/campaigns/best-practices)

Launch safely and protect your number health.