Poko API
Templates

Get template

GET
/motion-templates/{templateId}

One template: summary, category, aspect ratio and preview video.

Authorization

apiKey
headerAuthorizationBearer <token>

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

Path Parameters

templateId*string

Template id, from list_templates.

Response Body

Success

application/json
  1. response
success?boolean
data?
Example Request
curl -X GET 'https://api.poko.video/motion-templates/string'
Example Response
{  "success": true,  "data": {    "template": {      "nanoid": "flowjam-720p-8b4e2c6a1f9d",      "summary": "Polished animation showcasing Northwind Care, a health app, emphasising simplicity, personalisation and accuracy.",      "category": "healthcare",      "subcategory": "health_management",      "aspectRatio": "16:9",      "path": "/ai-ads/motion-templates/flowjam-720p-8b4e2c6a1f9d/video.mp4",      "createdAt": "2026-10-11T01:40:25.108Z",      "updatedAt": "2026-10-11T01:40:25.108Z",      "videoUrl": "https://cdn.example.com/ai-ads/motion-templates/flowjam-720p-8b4e2c6a1f9d/video.mp4"    }  }}

List template categories GET

Categories and subcategories list_templates can filter by.

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.