Skip to main content
POST
Import media

Authorizations

Authorization
string
header
required

A workspace API key.

Headers

idempotency-key
string
required

Required stable id for this logical write; reuse it after a timeout. Upload endpoints also require the same value in body.idempotencyKey.

Required string length: 1 - 255

Body

application/json
projectId
string
required

Workspace project that will own the frozen media.

Required string length: 1 - 200
sourceUrl
string<uri>
required

Public HTTPS media URL. Signed query parameters are never persisted.

Maximum string length: 2048
title
string

Display title for the frozen media; defaults to the source title when omitted.

Required string length: 1 - 160
platform
enum<string>

Primary source/output platform; defaults to youtube.

Available options:
tiktok,
instagram,
youtube,
reddit,
x

Response

Success.

success
boolean
required
projectId
string
required
Required string length: 1 - 200
asset
object
required
{key}
any