> For the complete documentation index, see [llms.txt](https://docs.avastudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avastudio.com/api-and-mcp/tools/drafts.md).

# Drafts

Turn research into briefs you can approve in Studio.

### draft\_briefs

Draft briefs for a brand grounded in market videos and, when Meta is connected, its own best ads: short-form video by default, or with output a carousel or static image ad; concepts only, no media. Costs 10 credits per brief plus the AI usage, typically ≈ 25 credits per brief in total. Returns a job\_id; poll jobs\_get, then use draft\_spec, draft\_prompts, draft\_check or draft\_open on the brief ids, saved in the brand's "From your agent" campaign in Ava Studio.

* **Permission:** Write drafts (`drafts:write`)
* **Price:** 10 credits per brief + tokens
* **Runs as a job:** yes. It returns a `job_id`; follow it with `jobs_get`, whose `result` is the output.
* **REST:** `POST /v1/draft_briefs`

#### Input

| Field                | Type             | Required | Description                                                                                                                     |
| -------------------- | ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `brand_id`           | string           | Yes      | Brand id from brand\_list or whoami.                                                                                            |
| `goal`               | string           |          | What the videos should achieve, e.g. launch a new flavor to gym-goers. At most 2000 characters.                                 |
| `platform`           | string           |          | One of `tiktok`, `reels`, `shorts`, `meta`.                                                                                     |
| `count`              | integer          |          | Number of briefs (1-5, default 3). Value 1 to 5.                                                                                |
| `output`             | string           |          | What to draft: video (default), carousel or static. Same price per brief. One of `video`, `carousel`, `static`.                 |
| `format`             | string           |          | Format from research\_formats. At most 200 characters.                                                                          |
| `research_video_ids` | array of strings |          | Reference video ids from research tools. At most 20 items.                                                                      |
| `my_ad_ids`          | array of strings |          | Your own Meta ad ids from research\_my\_ads. Each brief models one of them; implies use\_my\_ads. At most 10 items.             |
| `use_my_ads`         | boolean          |          | Blend your top Meta ads into drafting next to market videos. Default true when the brand has Meta connected with 3+ synced ads. |
| `idempotency_key`    | string           |          | Reuse the same key when retrying; the call runs and charges once. 8 to 128 characters.                                          |

### draft\_clone

Clone one short-form video (TikTok, Instagram Reel or YouTube Short URL) into ONE on-brand brief that keeps its format, beats, pacing, hook mechanic and caption style. Sources up to 2 minutes. Costs 10 credits plus the AI usage, typically ≈ 25 credits in total; returns a job\_id: poll jobs\_get, then use draft\_spec, draft\_prompts or draft\_open on the brief, saved in the brand's "From your agent" campaign in Ava Studio.

* **Permission:** Write drafts (`drafts:write`)
* **Price:** 10 credits per brief + tokens
* **Runs as a job:** yes. It returns a `job_id`; follow it with `jobs_get`, whose `result` is the output.
* **REST:** `POST /v1/draft_clone`

#### Input

| Field             | Type    | Required | Description                                                                                                                               |
| ----------------- | ------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `brand_id`        | string  | Yes      | Brand id from brand\_list or whoami.                                                                                                      |
| `url`             | string  | Yes      | Public video URL: tiktok.com/@user/video/ (or a vm.tiktok.com link), instagram.com/reel/ or youtube.com/shorts/. At most 2000 characters. |
| `goal`            | string  |          | What the clone should achieve for the brand, e.g. drive app installs. At most 2000 characters.                                            |
| `platform`        | string  |          | Where the brief will run. Default: the source's platform. One of `tiktok`, `reels`, `shorts`, `meta`.                                     |
| `preserve_hook`   | boolean |          | Keep the source's opening line nearly word for word (only brand words swapped). Default false: same hook mechanic, new words.             |
| `idempotency_key` | string  |          | Reuse the same key when retrying; the call runs and charges once. 8 to 128 characters.                                                    |

### draft\_iterate

Revise a brief from plain-language feedback (a punchier hook, less salesy, a different CTA); only revises briefs created through the API. Costs 8 credits plus the AI usage, typically ≈ 15 credits in total. Returns a job\_id; poll jobs\_get, the result is the revised Brief.

* **Permission:** Write drafts (`drafts:write`)
* **Price:** 8 credits + tokens
* **Runs as a job:** yes. It returns a `job_id`; follow it with `jobs_get`, whose `result` is the output.
* **REST:** `POST /v1/draft_iterate`

#### Input

| Field             | Type   | Required | Description                                                                            |
| ----------------- | ------ | -------- | -------------------------------------------------------------------------------------- |
| `brief_id`        | string | Yes      | Brief id from draft\_briefs, draft\_list or jobs\_get.                                 |
| `feedback`        | string | Yes      | 1 to 4000 characters.                                                                  |
| `idempotency_key` | string |          | Reuse the same key when retrying; the call runs and charges once. 8 to 128 characters. |

### draft\_check

Score a brief 0-100 against winning videos in its niche, with strengths, risks and the most similar winners; the score is an AI judgment, not a calibrated prediction of performance. Costs 3 credits plus the AI usage, typically ≈ 4 credits in total. Use it to compare briefs before committing; revise weak ones with draft\_iterate.

* **Permission:** Write drafts (`drafts:write`)
* **Price:** 3 credits + tokens
* **Runs as a job:** no. It answers within 60 seconds.
* **REST:** `POST /v1/draft_check`

#### Input

| Field             | Type   | Required | Description                                                                            |
| ----------------- | ------ | -------- | -------------------------------------------------------------------------------------- |
| `brief_id`        | string | Yes      | Brief id from draft\_briefs, draft\_list or jobs\_get.                                 |
| `idempotency_key` | string |          | Reuse the same key when retrying; the call runs and charges once. 8 to 128 characters. |

#### Output

| Field                                         | Type             | Description                                                                                                                                                                                                                                                                                                                                  |
| --------------------------------------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `score`                                       | number           | Value 0 to 100.                                                                                                                                                                                                                                                                                                                              |
| `strengths`                                   | array of strings |                                                                                                                                                                                                                                                                                                                                              |
| `risks`                                       | array of strings |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners`                             | array of objects |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].video_id`                  | string           | Corpus video id (TikTok video id). Pass to research\_similar or draft\_briefs.research\_video\_ids.                                                                                                                                                                                                                                          |
| `similar_winners[].platform`                  | string           | Source platform, e.g. tiktok.                                                                                                                                                                                                                                                                                                                |
| `similar_winners[].url`                       | string           | Original platform URL.                                                                                                                                                                                                                                                                                                                       |
| `similar_winners[].cover_image_url`           | string           |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].creator_handle`            | string           | Public handle of the poster (never commenters).                                                                                                                                                                                                                                                                                              |
| `similar_winners[].caption`                   | string           |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].hook_text`                 | string           | Opening hook line as analyzed.                                                                                                                                                                                                                                                                                                               |
| `similar_winners[].transcript_excerpt`        | string           | At most 200 characters. At most 200 characters.                                                                                                                                                                                                                                                                                              |
| `similar_winners[].format`                    | string           |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].product_category`          | string           |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].product_name`              | string           |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].style_tags`                | array of strings |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].is_ad`                     | boolean          |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].ad_brand`                  | string           |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].is_photo_post`             | boolean          |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].duration_sec`              | number           |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].posted_at`                 | string           |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].views`                     | number           | View count, rounded to 2 significant figures.                                                                                                                                                                                                                                                                                                |
| `similar_winners[].breakout_ratio`            | number           | Views relative to the creator's baseline, 1 decimal; >1 means outperformed.                                                                                                                                                                                                                                                                  |
| `similar_winners[].scores`                    | object           | Corpus quality bands (low, medium, high). Missing when not scored.                                                                                                                                                                                                                                                                           |
| `similar_winners[].scores.overall`            | string or null   |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].scores.clonability`        | string or null   |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].scores.hook_strength`      | string or null   |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].scores.performance`        | string or null   |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].scores.engagement_quality` | string or null   |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].scores.ad_conversion`      | string or null   |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].scores.product_fit`        | string or null   |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].scores.pacing_fit`         | string or null   |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].scores.freshness`          | string or null   |                                                                                                                                                                                                                                                                                                                                              |
| `similar_winners[].rank`                      | number           | Position on the ranking board this row came from.                                                                                                                                                                                                                                                                                            |
| `similar_winners[].similarity`                | number           | research\_similar only: vector similarity, higher is closer.                                                                                                                                                                                                                                                                                 |
| `credits_charged`                             | number           | API credits this call charged (0 when nothing was charged). A retry with the same idempotency\_key returns the original response and charges nothing more. Media credits the generation pipeline charges are not included: see media\_credits\_charged (creative\_produce, broll\_create and the Studio generation tools). Value at least 0. |
| `next_steps`                                  | array of strings | Short hints naming the next tool to call.                                                                                                                                                                                                                                                                                                    |

### draft\_list

List recent briefs, newest first, optionally for one brand or campaign. Use draft\_get for full details.

* **Permission:** Read drafts (`drafts:read`)
* **Price:** Free
* **Runs as a job:** no. It answers within 60 seconds.
* **REST:** `POST /v1/draft_list`

#### Input

| Field         | Type    | Required | Description                                    |
| ------------- | ------- | -------- | ---------------------------------------------- |
| `brand_id`    | string  |          |                                                |
| `campaign_id` | string  |          |                                                |
| `limit`       | integer |          | Max results (1-50, default 20). Value 1 to 50. |

#### Output

| Field                    | Type             | Description                                                                                                                                                                     |
| ------------------------ | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `briefs`                 | array of objects |                                                                                                                                                                                 |
| `briefs[].brief_id`      | string           |                                                                                                                                                                                 |
| `briefs[].campaign_id`   | string           |                                                                                                                                                                                 |
| `briefs[].brand_id`      | string           |                                                                                                                                                                                 |
| `briefs[].title`         | string           |                                                                                                                                                                                 |
| `briefs[].hook`          | string           |                                                                                                                                                                                 |
| `briefs[].status`        | string           | Draft lifecycle. candidate = drafted, awaiting review in Studio. One of `candidate`, `queued`, `planning`, `planned`, `generating`, `review`, `approved`, `failed`, `rejected`. |
| `briefs[].output_kind`   | string           | One of `video`, `static_image`, `carousel`.                                                                                                                                     |
| `briefs[].strength`      | string           | One of `High`, `Medium`, `Low`.                                                                                                                                                 |
| `briefs[].origin`        | object           |                                                                                                                                                                                 |
| `briefs[].origin.via`    | string           | "api" for briefs created through this API.                                                                                                                                      |
| `briefs[].origin.client` | string           |                                                                                                                                                                                 |
| `briefs[].created_at`    | string           | ISO-8601 timestamp                                                                                                                                                              |
| `briefs[].updated_at`    | string           | ISO-8601 timestamp                                                                                                                                                              |
| `next_steps`             | array of strings | Short hints naming the next tool to call.                                                                                                                                       |

### draft\_get

Read one brief in full (script, storyboard, rationale, status). Use after draft\_list or to re-check a brief after draft\_iterate.

* **Permission:** Read drafts (`drafts:read`)
* **Price:** Free
* **Runs as a job:** no. It answers within 60 seconds.
* **REST:** `POST /v1/draft_get`

#### Input

| Field         | Type   | Required | Description                                            |
| ------------- | ------ | -------- | ------------------------------------------------------ |
| `brief_id`    | string | Yes      | Brief id from draft\_briefs, draft\_list or jobs\_get. |
| `campaign_id` | string |          | Speeds up lookup when known.                           |

#### Output

| Field                                | Type             | Description                                                                                                                                                                     |
| ------------------------------------ | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `brief_id`                           | string           |                                                                                                                                                                                 |
| `campaign_id`                        | string           |                                                                                                                                                                                 |
| `brand_id`                           | string           |                                                                                                                                                                                 |
| `title`                              | string           |                                                                                                                                                                                 |
| `status`                             | string           | Draft lifecycle. candidate = drafted, awaiting review in Studio. One of `candidate`, `queued`, `planning`, `planned`, `generating`, `review`, `approved`, `failed`, `rejected`. |
| `output_kind`                        | string           | One of `video`, `static_image`, `carousel`.                                                                                                                                     |
| `platform`                           | string           | One of `tiktok`, `reels`, `shorts`, `meta`.                                                                                                                                     |
| `concept`                            | string           | One-paragraph creative concept.                                                                                                                                                 |
| `hook`                               | string           |                                                                                                                                                                                 |
| `body`                               | string           |                                                                                                                                                                                 |
| `cta`                                | string           |                                                                                                                                                                                 |
| `script`                             | array of objects |                                                                                                                                                                                 |
| `script[].id`                        | string           | Section tag, e.g. Hook, Body\_1, Cta.                                                                                                                                           |
| `script[].label`                     | string           |                                                                                                                                                                                 |
| `script[].channel`                   | string           | One of `spoken`, `voiceover`, `caption`.                                                                                                                                        |
| `script[].role`                      | string           |                                                                                                                                                                                 |
| `script[].text`                      | string           |                                                                                                                                                                                 |
| `storyboard`                         | array of objects |                                                                                                                                                                                 |
| `storyboard[].role`                  | string           | One of `hook`, `build`, `proof`, `cta`.                                                                                                                                         |
| `storyboard[].beat`                  | string           | On-screen action / story beat (not a model prompt).                                                                                                                             |
| `slides`                             | array of objects | Carousel briefs (output\_kind carousel): the slides in order.                                                                                                                   |
| `slides[].index`                     | integer          | 1-based slide order. Value at least 1.                                                                                                                                          |
| `slides[].role`                      | string           | hook, body or cta.                                                                                                                                                              |
| `slides[].headline`                  | string           | Main on-slide text (empty on a text-free slide).                                                                                                                                |
| `slides[].body`                      | string           | Supporting on-slide line under the headline.                                                                                                                                    |
| `slides[].visual_description`        | string           | The image itself: scene, subject, framing. No text.                                                                                                                             |
| `static_ad`                          | object           | Static briefs (output\_kind static\_image): the one image ad.                                                                                                                   |
| `static_ad.headline`                 | string           |                                                                                                                                                                                 |
| `static_ad.body`                     | string           |                                                                                                                                                                                 |
| `static_ad.cta`                      | string           |                                                                                                                                                                                 |
| `static_ad.visual_description`       | string           | The image itself: scene, subject, framing. No text.                                                                                                                             |
| `static_ad.aspect_ratio`             | string           | One of `9:16`, `4:5`, `1:1`, `16:9`.                                                                                                                                            |
| `caption`                            | string           | Post caption for a carousel or static, hashtags included.                                                                                                                       |
| `variables`                          | object           |                                                                                                                                                                                 |
| `variables.angle`                    | object           |                                                                                                                                                                                 |
| `variables.angle.label`              | string           |                                                                                                                                                                                 |
| `variables.angle.statement`          | string           |                                                                                                                                                                                 |
| `variables.hook`                     | object           |                                                                                                                                                                                 |
| `variables.hook.type`                | string           |                                                                                                                                                                                 |
| `variables.hook.text`                | string           |                                                                                                                                                                                 |
| `variables.format`                   | object           |                                                                                                                                                                                 |
| `variables.format.type`              | string           |                                                                                                                                                                                 |
| `variables.format.aspect`            | string           | One of `9:16`, `4:5`, `1:1`, `16:9`.                                                                                                                                            |
| `variables.format.duration_sec`      | number           |                                                                                                                                                                                 |
| `variables.cast`                     | object           |                                                                                                                                                                                 |
| `variables.cast.actor_id`            | string           |                                                                                                                                                                                 |
| `variables.cast.name`                | string           |                                                                                                                                                                                 |
| `variables.cast.role`                | string           |                                                                                                                                                                                 |
| `variables.cta`                      | object           |                                                                                                                                                                                 |
| `variables.cta.text`                 | string           |                                                                                                                                                                                 |
| `variables.cta.offer`                | string           |                                                                                                                                                                                 |
| `rationale`                          | object           |                                                                                                                                                                                 |
| `rationale.test_hypothesis`          | string           | The audience response this creative is designed to test.                                                                                                                        |
| `rationale.audience`                 | object           |                                                                                                                                                                                 |
| `rationale.audience.description`     | string           |                                                                                                                                                                                 |
| `rationale.audience.basis`           | string           | One of `observed`, `inferred`.                                                                                                                                                  |
| `rationale.why_now`                  | string           |                                                                                                                                                                                 |
| `rationale.evidence`                 | object           |                                                                                                                                                                                 |
| `rationale.evidence.type`            | string           |                                                                                                                                                                                 |
| `rationale.evidence.cite`            | string           |                                                                                                                                                                                 |
| `rationale.evidence.provenance`      | string           | One of `verified`, `computed`, `estimated`.                                                                                                                                     |
| `rationale.predicted_strength`       | object           |                                                                                                                                                                                 |
| `rationale.predicted_strength.level` | string           | One of `High`, `Medium`, `Low`.                                                                                                                                                 |
| `rationale.predicted_strength.why`   | string           |                                                                                                                                                                                 |
| `basis`                              | string           | One of `pattern`, `competitor`, `trend`, `first`.                                                                                                                               |
| `strength`                           | string           | One of `High`, `Medium`, `Low`.                                                                                                                                                 |
| `source`                             | object           |                                                                                                                                                                                 |
| `source.kind`                        | string           | One of `ugc_recreate`, `competitor_recreate`, `original`.                                                                                                                       |
| `source.url`                         | string           | Original platform URL of the reference video/ad.                                                                                                                                |
| `source.video_id`                    | string           |                                                                                                                                                                                 |
| `source.competitor_brand`            | string           |                                                                                                                                                                                 |
| `source.format`                      | string           | draft\_clone: the source's format (e.g. talking\_head), kept in the brief.                                                                                                      |
| `source.beats`                       | array of objects | draft\_clone: the source's beats, in order, that the brief follows.                                                                                                             |
| `source.beats[].action`              | string           | What visibly happens in this beat of the source.                                                                                                                                |
| `source.beats[].visual_mode`         | string           | e.g. presenter, app-cutaway, product-action, reaction.                                                                                                                          |
| `source.beats[].duration_sec`        | number           | Approximate length of this beat in the source.                                                                                                                                  |
| `source.beats[].speech`              | string           | One of `dialogue`, `voiceover`, `none`.                                                                                                                                         |
| `source.duration_sec`                | number           | draft\_clone: source video length in seconds.                                                                                                                                   |
| `estimated_duration_sec`             | number           |                                                                                                                                                                                 |
| `credit_range`                       | array of values  | Estimated credits to produce the video later in Studio. 2 to 2 items.                                                                                                           |
| `preview_image_url`                  | string           |                                                                                                                                                                                 |
| `rejection_reason`                   | string           |                                                                                                                                                                                 |
| `origin`                             | object           |                                                                                                                                                                                 |
| `origin.via`                         | string           | "api" for briefs created through this API.                                                                                                                                      |
| `origin.client`                      | string           |                                                                                                                                                                                 |
| `studio_url`                         | string           |                                                                                                                                                                                 |
| `created_at`                         | string           | ISO-8601 timestamp                                                                                                                                                              |
| `updated_at`                         | string           | ISO-8601 timestamp                                                                                                                                                              |
| `evidence`                           | array of objects | What the brief cites, primary reference first: market videos (source corpus), your own Meta ads (source my\_ad) and, for draft\_clone, the cloned video (source clone\_source). |
| `next_steps`                         | array of strings | Short hints naming the next tool to call.                                                                                                                                       |

### draft\_spec

Turn a brief into a shot list: per-shot role, duration, action, framing, camera, performer, speech, on-screen text and audio. Follow with draft\_prompts for model-specific prompts, then video\_generate or image\_generate after the user approves the estimate.

* **Permission:** Read drafts (`drafts:read`)
* **Price:** Free
* **Runs as a job:** no. It answers within 60 seconds.
* **REST:** `POST /v1/draft_spec`

#### Input

| Field      | Type   | Required | Description                                            |
| ---------- | ------ | -------- | ------------------------------------------------------ |
| `brief_id` | string | Yes      | Brief id from draft\_briefs, draft\_list or jobs\_get. |

#### Output

| Field                     | Type             | Description                                                                                               |
| ------------------------- | ---------------- | --------------------------------------------------------------------------------------------------------- |
| `brief_id`                | string           |                                                                                                           |
| `derived_from`            | string           | ad\_spec = compiled production plan; storyboard = derived from the draft. One of `ad_spec`, `storyboard`. |
| `aspect_ratio`            | string           | One of `9:16`, `4:5`, `1:1`, `16:9`.                                                                      |
| `total_duration_sec`      | number           |                                                                                                           |
| `format`                  | string           |                                                                                                           |
| `hook_mechanic`           | string           |                                                                                                           |
| `audio`                   | object           |                                                                                                           |
| `audio.speech`            | string           | One of `dialogue`, `voiceover`, `mixed`, `none`.                                                          |
| `audio.music`             | string           | One of `extracted`, `generated`, `none`.                                                                  |
| `audio.music_description` | string           |                                                                                                           |
| `shots`                   | array of objects | At least 1 items.                                                                                         |
| `shots[].index`           | integer          | Value at least 0.                                                                                         |
| `shots[].role`            | string           | One of `hook`, `build`, `proof`, `cta`.                                                                   |
| `shots[].duration_sec`    | number           |                                                                                                           |
| `shots[].action`          | string           | What happens on screen.                                                                                   |
| `shots[].framing`         | string           | e.g. medium close-up, selfie arm's length.                                                                |
| `shots[].camera`          | string           | e.g. handheld, static tripod, slow push-in.                                                               |
| `shots[].performer`       | string           | One of `actor`, `actors`, `none`.                                                                         |
| `shots[].speech`          | object           |                                                                                                           |
| `shots[].speech.kind`     | string           | One of `dialogue`, `voiceover`, `none`.                                                                   |
| `shots[].speech.text`     | string           |                                                                                                           |
| `shots[].speech.speaker`  | string           | One of `person`, `off-camera`.                                                                            |
| `shots[].speech.voice`    | string           | Voice description, when known.                                                                            |
| `shots[].on_screen_text`  | array of strings |                                                                                                           |
| `shots[].audio`           | string           | Music/SFX notes for this shot.                                                                            |
| `notes`                   | array of strings |                                                                                                           |
| `next_steps`              | array of strings | Short hints naming the next tool to call.                                                                 |

### draft\_prompts

Write per-shot generation prompts for a specific video or image model (seedance-2, veo-3.1, kling-3, sora-2, runway-gen4, nano-banana, gpt-image, generic). Carousel and static briefs get one image prompt per slide and need an image target (nano-banana, gpt-image or generic). This tool only writes prompts; to fulfill a generation request, quote generation\_estimate then call video\_generate or image\_generate after approval and poll jobs\_get for the media.

* **Permission:** Read drafts (`drafts:read`)
* **Price:** Free
* **Runs as a job:** no. It answers within 60 seconds.
* **REST:** `POST /v1/draft_prompts`

#### Input

| Field      | Type   | Required | Description                                                                                                |
| ---------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------- |
| `brief_id` | string | Yes      | Brief id from draft\_briefs, draft\_list or jobs\_get.                                                     |
| `target`   | string | Yes      | One of `seedance-2`, `veo-3.1`, `kling-3`, `sora-2`, `runway-gen4`, `nano-banana`, `gpt-image`, `generic`. |

#### Output

| Field                     | Type             | Description                                                                                                |
| ------------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------- |
| `brief_id`                | string           |                                                                                                            |
| `target`                  | string           | One of `seedance-2`, `veo-3.1`, `kling-3`, `sora-2`, `runway-gen4`, `nano-banana`, `gpt-image`, `generic`. |
| `shots`                   | array of objects | At least 1 items.                                                                                          |
| `shots[].shot_index`      | integer          | Value at least 0.                                                                                          |
| `shots[].prompt`          | string           |                                                                                                            |
| `shots[].negative_prompt` | string           |                                                                                                            |
| `shots[].duration_sec`    | number           |                                                                                                            |
| `shots[].aspect_ratio`    | string           | One of `9:16`, `4:5`, `1:1`, `16:9`.                                                                       |
| `shots[].reference_notes` | string           | Which brand media / references to attach, if any.                                                          |
| `shots[].params`          | object           | Target-specific parameters (model, seed, motion, etc.).                                                    |
| `notes`                   | array of strings |                                                                                                            |
| `next_steps`              | array of strings | Short hints naming the next tool to call.                                                                  |

### draft\_open

Get the Ava Studio link where the brief can be reviewed, approved and produced. Share it with the user when they want to see or approve a draft.

* **Permission:** Read drafts (`drafts:read`)
* **Price:** Free
* **Runs as a job:** no. It answers within 60 seconds.
* **REST:** `POST /v1/draft_open`

#### Input

| Field      | Type   | Required | Description                                            |
| ---------- | ------ | -------- | ------------------------------------------------------ |
| `brief_id` | string | Yes      | Brief id from draft\_briefs, draft\_list or jobs\_get. |

#### Output

| Field        | Type             | Description                               |
| ------------ | ---------------- | ----------------------------------------- |
| `studio_url` | string           |                                           |
| `next_steps` | array of strings | Short hints naming the next tool to call. |
