POST
TypeScript client

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

idempotency-key
string
required

a string at most 200 character(s) long

Required string length: 1 - 200

Path Parameters

teamId
string
required

Team (workspace) id (UUID). Discover ids via the list teams endpoint or the agent context.

Body

application/json
draft
object
required

Minimal slideshow description. Only slide text is required - the pinned renderer runtime, source bundle, output size, styles, caption layout and identifiers are all filled in for you.

title
string

a string at most 500 character(s) long

Maximum string length: 500
autoRender
boolean

When true, queue a render immediately after creating the slideshow; defaults to false.

Response

Success

contentItemId
string<uuid>
required

a Universally Unique Identifier

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
teamId
string<uuid>
required

a Universally Unique Identifier

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
sourceContentItemId
string<uuid> | null
required

a Universally Unique Identifier

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
title
string | null
required
status
string
required
payloadId
string<uuid>
required

a Universally Unique Identifier

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
revision
integer
required

an integer

creativeHash
string | null
required
currentCreativeHash
string | null
required
renderedCreativeHash
string | null
required
renderFresh
boolean
required
activeRun
object | null
required
latestRun
object | null
required

The most recent agent run whatever its outcome, so a failure is visible without having kept its run id.

latestRenderJob
object | null
required
project
object | null
required

Complete deterministic slideshow project, including slides, styles, asset bindings, output settings, and the pinned renderer runtime.

assetRefs
any[]
required
browserPreviewUrl
string
previewCreativeHash
string