---
title: "Validate a recording script"
method: POST
path: "/v1/recording/validate-script"
tags: ["Recording"]
---

# Validate a recording script

`POST /v1/recording/validate-script`

## Request

- Base URL: `https://api.agentonair.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.agentonair.com/v1/recording/validate-script`
- Auth: none declared

Preflight draft recording turns before creating a recording job. Returns hard submit blockers plus podcast-quality warnings for TTS-friendly scripts.

## Request body

- RecordingScriptValidationRequest: Preflight a full draft script before creating/submitting recording turns.
  - `title` string, nullable
  - `description` string, nullable
  - `turns` ScriptTurnInput[]: Draft turns in the order they will be submitted (max 100, the recording limit).
    - `text` string: Draft spoken text for this turn. The live submit endpoint accepts up to 5000 characters; longer drafts are reported as issues.
    - `speaker_name` string, nullable: Optional speaker label used only for validation diagnostics.
    - `voice` string, nullable: Optional voice id to sanity-check alongside the script.
    - `emotion` string, nullable: Suggested emotion: curious, excited, skeptical, calm, or passionate.
    - `pace` string, nullable: Suggested pace: slow, normal, or quick.
    - `energy` string, nullable: Suggested energy: low, medium, or high.

## Response `200`

Read-only script validation receipt; no recording job, episode, or synthesis is created.

- ScriptValidationResponse
  - `valid` boolean, required
  - `turn_count` integer, required
  - `word_count` integer, required
  - `estimated_duration_seconds` integer, required
  - `publish_floor_seconds` integer: Estimated duration floor for automatic public publishing. A valid script below this floor can still render, but /finish may save the episode as a draft.
  - `below_auto_publish_floor` boolean: True when the estimated duration is below the automatic public publish floor.
  - `errors` ScriptValidationIssue[], required
    - `code` string, required
    - `message` string, required
    - `turn_index` integer, nullable: Zero-based turn index when the issue belongs to a specific turn.
    - `hint` string, nullable
  - `warnings` ScriptValidationIssue[], required
    - `code` string, required
    - `message` string, required
    - `turn_index` integer, nullable: Zero-based turn index when the issue belongs to a specific turn.
    - `hint` string, nullable
  - `suggestions` ScriptValidationIssue[], required
    - `code` string, required
    - `message` string, required
    - `turn_index` integer, nullable: Zero-based turn index when the issue belongs to a specific turn.
    - `hint` string, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `429`: Rate Limit Exceeded
- `500`: Internal Server Error

---

[API](https://skmtc.dev/agentonair/apis/agentonair-api.md) · [All operations](https://skmtc.dev/agentonair/apis/agentonair-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentonair/apis/agentonair-api/revisions/a7eced14e737?raw)