Poko API
Exports

Export video

POST
/api/workspaces/{workspaceId}/videos/{videoId}/exports

Render a finished video to a file. Poll get_export for the download link.

Authorization

apiKey
headerAuthorizationBearer <token>

A Poko API key (poko_live_…) from Poko Motion → Settings → API.

Path Parameters

workspaceId*string

Workspace id. GET /api/me returns the key's default workspace (workspaceId); GET /api/workspace/mine lists all of them.

videoId*string

Video id: requestId from create_video, continue_video or list_videos.

Header Parameters

Idempotency-Key?string

Send the same value when you retry, and Poko answers with the first result instead of starting the work again.

Request Body

application/json
  1. body
format?string
Default"mp4"
Value in"mp4""webm"
fps?integer
Default30
Value in243060
quality?string
Default"standard"
Value in"draft""standard""high"
speed?number
Range0.5 <= value <= 2
Default1
workers?integer
Range1 <= value <= 24
Default1

Response Body

Success

application/json
  1. response
success?boolean
data?
Example Request
curl -X POST 'https://api.poko.video/api/workspaces/string/videos/string/exports' \  -H 'Content-Type: application/json' \  -d '{  "format": "mp4",  "fps": 30,  "quality": "high"}'
Example Response
{  "success": true,  "data": {    "exportId": "c4e8a2f1-7d3b-4e9c-b5a6-0f1e2d3c4b5a",    "status": "queued",    "phase": null,    "progress": null  }}