Skip to main content
POST
Create project

Authorizations

Authorization
string
header
required

A workspace API key.

Headers

idempotency-key
string
required

Required durable retry key. Reuse it only for the identical project creation request.

Required string length: 1 - 255

Body

application/json
title
string

Optional human-readable name. Omit to create an untitled project.

Maximum string length: 120
kind
enum<string>

Legacy alias for mediaType, accepted so existing callers keep working. Prefer mediaType; when both are sent they must agree.

Available options:
video,
audio
mediaType
enum<string>

Choose audio or video. Video also requires videoPath. Omit both for an audio project.

Available options:
video,
audio
videoPath
enum<string>

A supported specialist video path. general is the final fallback.

Available options:
talking-head,
faceless-explainer,
product-demo,
interview-podcast,
course-video,
how-to-video,
motion-graphics,
chess-video,
algorithm-explainer,
science-explainer,
story-video,
code-update,
asset-animator,
captions-copy,
general
visibility
enum<string>
default:private

Who can discover the project. Defaults to private.

Available options:
private,
workspace

Response

Success.

success
boolean
required
project
object
required

The container capability output is filed under.

{key}
any