---
title: "Agent Script"
method: POST
path: "/v1/agent/scripts"
---

# Agent Script

`POST /v1/agent/scripts`

## Request

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

## Request body

- AgentScriptBody
  - `topic` string, required: What the video is about.
  - `audience` string, required: Who the video is for.
  - `platform` 'tiktok' | 'reels' | 'youtube-shorts': Where the video will be posted.
  - `duration` integer: Target spoken length in seconds.
  - `tone` string, nullable: Optional tone or style note.
  - `temperature` number: Creativity, from 0 (steady) to 1.5 (loosest).
  - `mode` 'take' | 'story' | 'skit' | 'howto': Writing mode: take = a point of view and a clear close; story = one moment, a turn — not a lecture; skit = two voices, a bit; howto = steps a viewer can follow.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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