---
title: "Preview Campaign Test Run"
method: POST
path: "/api/v1/campaigns/{campaign_id}/test-runs/preview"
tags: ["campaigns"]
---

# Preview Campaign Test Run

`POST /api/v1/campaigns/{campaign_id}/test-runs/preview`

## 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}/test-runs/preview`
- Auth: none declared

The test cases "Test" would run on the campaign's phone agents, built
from the working copy's own rules, and the agents it can call. Saves and
spends nothing. 422 when the campaign is incomplete or has no phone agent.

## Path parameters

- `campaign_id` string, uuid, required

## Response `200`

Successful Response

- CampaignTestPreviewRead: What "Test" would run (PLAN-agent-test-runs PR 3): nothing saved, nothing spent. ``max_call_seconds`` bounds each call.
  - `agents` TestableAgentRead[], required
    - `voice_agent_id` string, uuid, required
    - `name` string, required
    - `group_name` string, required
  - `cases` AgentTestCaseSpec[], required
    - `kind` string, required
    - `name` string, required
    - `caller_instructions` string, required
    - `expectations` string, required
    - `as_of` string, date-time, nullable
    - `guest` 'member' | 'not_member', nullable: Who the simulated caller is for a campaign's members-only phase: once they give an email, they count as a member of the phase's group or not (T-D4). Until then the agent sees a guest who has given no email.
  - `max_call_seconds` integer, 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/test-runs/preview/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)
