Skip to main content
POST
Start a durable import job

Authorizations

Authorization
string
header
required

Permanent personal API key created in the dashboard. Example: curl -H "Authorization: Bearer aty_…" https://your-host/v1/projects

Headers

Idempotency-Key
string

Optional caller-provided idempotency key.

Maximum string length: 200

Body

application/json
provider
enum<string>
required
Available options:
youtube
Example:

"youtube"

kind
enum<string>
required
Available options:
video,
channel,
playlist,
comments,
deep-comments
entityId
string
required
projectId
string
idempotencyKey
string
Maximum string length: 200

Response

Import queued or an existing idempotent job returned.

id
string
required
status
string
required
progress
integer
required
Required range: 0 <= x <= 100