Uploads
Upload file
POST
Upload a file to make a video from: PDF or PowerPoint (50 MB), MP4/MOV/WebM for MotionCut (200 MB), or PNG/JPEG/WebP to pass as a reference (20 MB). PUT the file to uploadUrl with uploadHeaders, then use fileUrl as sourceUrl in create_video or as a reference path. Files are deleted after a day.
apiKeyheader
AuthorizationBearer <token>A Poko API key (poko_live_…) from Poko Motion → Settings → API.
workspaceId*stringWorkspace id. GET /api/me returns the key's default workspace (workspaceId); GET /api/workspace/mine lists all of them.
application/json- body
fileName*stringLength
1 <= length <= 500contentType*stringValue in
"application/pdf""application/vnd.openxmlformats-officedocument.presentationml.presentation""video/mp4""video/quicktime""video/webm""image/png""image/jpeg""image/webp"sizeBytes*integerRange
1 <= valueSuccess
application/json- response
success?booleandata?curl -X POST 'https://api.poko.video/api/workspaces/string/uploads' \ -H 'Content-Type: application/json' \ -d '{ "fileName": "pitch-deck.pdf", "contentType": "application/pdf", "sizeBytes": 2483021}'Example Response
{ "success": true, "data": { "uploadUrl": "https://examplestorage.blob.core.windows.net/cloud-executions/w/Wk7pQ2xR/uploads/6b2d8f4a-1c3e-4a5b-9d7f-2e4c6a8b0d1f/pitch-deck.pdf?sv=2025-05-05&spr=https&st=2026-11-05T09%3A59%3A00Z&se=2026-11-05T12%3A00%3A00Z&sr=b&sp=cw&sig=EXAMPLE_SIGNATURE", "uploadMethod": "PUT", "uploadHeaders": { "Content-Type": "application/pdf", "x-ms-blob-type": "BlockBlob" }, "uploadExpiresAt": "2026-11-05T12:00:00.000Z", "fileUrl": "https://examplestorage.blob.core.windows.net/cloud-executions/w/Wk7pQ2xR/uploads/6b2d8f4a-1c3e-4a5b-9d7f-2e4c6a8b0d1f/pitch-deck.pdf?sv=2025-05-05&spr=https&st=2026-11-05T09%3A59%3A00Z&se=2026-11-06T10%3A00%3A00Z&sr=b&sp=r&sig=EXAMPLE_SIGNATURE", "fileUrlExpiresAt": "2026-11-06T10:00:00.000Z" }}