---
title: "Replay"
method: POST
path: "/conversations/{id}/replay"
tags: ["conversations"]
---

# Replay

`POST /conversations/{id}/replay`

Replays an ended conversation by re-running its recorded audio through an
agent. Requires API key or access token authentication. The conversation must
have audio recordings available and an associated agent (or one specified in
the request body).

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Request body

- ReplayConversationRequest
  - `agent` string — Name of the agent to replay the conversation with. Defaults to the agent originally associated with the conversation.

## Response `200`

Replay started

- ConversationsReplayResponse200
  - `message` string, required — Confirmation that the replay has started.

## Other responses

- `400` — Invalid parameters
- `401` — Unauthorized (authentication missing or invalid)
- `403` — Forbidden
- `404` — Conversation not found
- `409` — Cannot replay an active conversation
- `422` — Conversation cannot be replayed (no audio, deleted recordings, or no agent)
- `429` — Concurrency limit reached
- `500` — Internal server error
- `503` — Insufficient capacity available to start the replay.

---

[API](https://skmtc.net/phonic/apis/api-reference.md) · [All operations](https://skmtc.net/phonic/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phonic/api-reference/revisions/7f8c81a5a990/schema)