---
title: creative_timeline_plan
description: Validate a timeline for the connected workspace when its Creative
  flag is enabled.
canonical_url: https://orchestor.io/docs/en/mcp/tools/creative/creative_timeline_plan
markdown_url: https://orchestor.io/docs/en/mcp/tools/creative/creative_timeline_plan.md
contentType: reference
---

# creative_timeline_plan

Validate a timeline for the connected workspace when its Creative flag is enabled.

**Operation** Read.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `body` | object | Yes | Timeline settings. |
| `body.audio` | object | Yes | Set `duration_seconds` from 1 to 1800 and choose a saved `url`, ordered `parts`, or `mode: silence`. |
| `body.video` | array | Yes | Provide 1–200 ordered clips or stills. Each needs a `source_url`, `start`, and `duration`. Optional fields include `source_in`, `fit`, and the incoming `transition`. |
| `body.soundtrack` | object | No | Provide a saved audio `url` with optional gain, looping, fade-out, or ducking under the spine. |
| `body.output` | object | No | Set output geometry, frame rate, and intro or outro fades. The output format is MP4. |
| `body.render` | object | No | Set the render `strategy`, `chunk_max_segments`, and short-source `pad_mode`. |

Plan returns coverage, transition count, render cost estimates, and warnings it can infer from the request. The free check reads the timeline description and returns its result immediately. Render verifies that workspace media exists and can be decoded.

## Sample prompt

```text
Check my 75-second timeline with a silent spine and two clips. Tell me the billable minutes before rendering.
```

[Creative](https://orchestor.io/docs/en/mcp/tools/creative.md) · [Tools](https://orchestor.io/docs/en/mcp/tools.md)

---

[Documentation index](https://orchestor.io/docs/llms.txt)
