---
title: "Start Campaign Rehearsal"
method: POST
path: "/api/v1/campaigns/{campaign_id}/rehearsals"
tags: ["campaigns"]
---

# Start Campaign Rehearsal

`POST /api/v1/campaigns/{campaign_id}/rehearsals`

## Request

- Base URL: `https://api.getanana.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getanana.com/api/v1/campaigns/{campaign_id}/rehearsals`
- Auth: none declared

Rehearse the working copy on the campaign's agents for two hours: test
chats and simulated calls see it as at ``as_of_local``, for the chosen
guest. Replaces the organization's previous rehearsal. 422 while the
working copy is incomplete.

## Path parameters

- `campaign_id` string, uuid, required

## Request body

- RehearsalCreate: Rehearse a campaign on its agents (PR 13): test conversations see the working copy as at ``as_of_local`` (the tenant's wall clock, no offset), for a guest who is or is not a member.
  - `as_of_local` string, date-time, required
  - `guest` 'member' | 'not_member', required: Who a rehearsal pretends the guest is (PLAN-agent-campaigns PR 13).

## Response `201`

Successful Response

- RehearsalRead: The tenant's active rehearsal.
  - `campaign_id` string, uuid, required
  - `campaign_name` string, required
  - `as_of_local` string, date-time, required
  - `guest` 'member' | 'not_member', required: Who a rehearsal pretends the guest is (PLAN-agent-campaigns PR 13).
  - `started_by_name` string, nullable, required
  - `expires_at` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-18** `4e699bbdcfbd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/campaigns/:campaign_id/rehearsals/post.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) - [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/4e699bbdcfbd?raw)
