Video.draft

Its Inputs, Outputs, Effects and guards quote the hub’s Video.draft; this page adds what each Venue honors, its limits and a worked call.

InputsCopy Anchor Link

OutputsCopy Anchor Link

EffectsCopy Anchor Link

Action class

None: no approval rule names it, so it runs within its seat’s Permissions and Limits

Modes

• try: Writes the timeline and returns it with a frame list; nothing is rendered or stored.
• send: Returns a pending Action at once; Video.drafted fires when the timeline and its preview render.
• do: Waits for the preview render, about a minute for 30 seconds, and returns the Video.

Idempotency

Only with a key: the same Idempotency-Key and input return the first Action, and the same key with other input returns 409. A repeat with the same key returns the first draft; a new key drafts again from the records as they are now.

Saved or shared

The Video, its timeline and the record each on-screen claim reads, so a changed price or count marks the draft stale.

Emits

Video.drafted with { video, brand, offer, claims }

Performed by

Content lead

Price

Free on your own account: the platform charges nothing for the call.

On each VenueCopy Anchor Link

It acts on your own records and reaches no Venue, so every account answers the same way.

What try doesCopy Anchor Link

Runs every check the call meets and returns the record as it would be; nothing is stored, sent or posted.

Refuses whenCopy Anchor Link

{
  "type": "https://startupbuilder.dev/errors/synthetic-media",
  "title": "Synthetic media",
  "status": 422,
  "detail": "An invented testimonial, a synthetic person speaking as a Customer, or a face or voice with no yes.",
  "fix": "Use a real Customer’s words with their yes, or show the product instead.",
  "next": {
    "verb": "Content.draft",
    "input": {}
  },
  "instance": "https://api.sb/leaseline.app/actions/action_1"
}

When it waitsCopy Anchor Link

In send mode it returns a pending Action, reason: 'running' until the preview renders, and Video.drafted delivers the result.

await $.Watch.create({
  selector: 'Video.drafted',
  url: 'https://leaseline.app/hooks/sb'
})

ExampleCopy Anchor Link

A refusal: its offer asks for a customer testimonial with no recorded yes, so the draft refuses before a frame is written.

Draft a 30-second video for the Portfolio plan: renewal notices go out
60 days early, for every owner, for `offer_test_testimonial`.

{
  "type": "https://startupbuilder.dev/errors/synthetic-media",
  "title": "Synthetic media",
  "status": 422,
  "detail": "An invented testimonial, a synthetic person speaking as a Customer, or a face or voice with no yes.",
  "fix": "Use a real Customer’s words with their yes, or show the product instead.",
  "next": {
    "verb": "Content.draft",
    "input": {}
  },
  "instance": "https://api.sb/leaseline.app/actions/action_1"
}

To retry, send the same Idempotency-Key: the retry returns the first answer for $0. A new key reads again.

Used byCopy Anchor Link

• Agent tasks: Ad kit
• Jobs: Make content

RelatedCopy Anchor Link

• Video.finalizeLifts a Video’s draft mark once every claim it makes reads from a live record, so its cuts can publish.
• File.generateMakes an image, a clip, speech or music from a prompt and your reference Files, and records how it was made.
• File.editMakes a new File from one you have, by instruction, such as upscaling or animating a still; the original stays.
• Voice.cloneTrains a Voice on a real speaker’s recordings, after the speaker records consent in that same voice.
• Voice.retireDeletes a Voice’s trained copy and refuses new speech in it, keeping the record and every File it made.