---
title: "Start Agent Preview"
method: POST
path: "/v1/interviews/{interview_id}/agent-preview/start"
tags: ["interviews"]
---

# Start Agent Preview

`POST /v1/interviews/{interview_id}/agent-preview/start`

Create a disposable preview conversation so the creator can test the agent.

Mints a test-lab contact (``TEST_LAB_DEPARTMENT`` marker, so the run is
excluded from reports and insights by construction) plus a conversation
under the real campaign, and returns the same session URL a participant
would receive. Works on drafts: the builder persists its editor state
right before calling this, so the conversation follows the current guide.

## Path parameters

- `interview_id` string, uuid, required

## Headers

- `X-API-Key` string, nullable

## Request body

- AgentPreviewStartRequest
  - `display_name` string, nullable

## Response `200`

Successful Response

- AgentPreviewStartResponse
  - `session_url` string, required
  - `conversation_id` string, uuid, required
  - `contact_id` string, uuid, required
  - `session_token` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ontora/apis/ontora-api.md) · [All operations](https://skmtc.dev/ontora/apis/ontora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ontora/ontora-api/revisions/7f57037fd94b/schema)