Poko API
Brand kit

Get brand kit

GET
/api/workspaces/{workspaceId}/brand-kit

Brand guidance (markdown) and brand files. Read it before making a video.

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.

Response Body

Success

application/json
  1. response
success?boolean
data?
Example Request
curl -X GET 'https://api.poko.video/api/workspaces/string/brand-kit'
Example Response
{  "success": true,  "data": {    "markdown": "# Acme brand\n\n- Primary color: #4F46E5\n- Font: Inter\n- Use logo.png on dark backgrounds",    "files": [      {        "id": "Fq8LmZp2Xc_W",        "type": "asset",        "createdBy": "user_2Nf7QxKp4TzLm9WbRc3HvYd8EaJ",        "name": "logo.png",        "originalFileName": "acme-logo-transparent.png",        "path": "/ai-ads/w/Wk7pQ2xR/brand-kit/019a5f3c-7b21-7c4e-9a8d-3e2f1b0c9d8e.png",        "url": "https://cdn.example.com/ai-ads/w/Wk7pQ2xR/brand-kit/019a5f3c-7b21-7c4e-9a8d-3e2f1b0c9d8e.png",        "mimeType": "image/png",        "sizeBytes": 90523,        "createdAt": "2026-09-17T07:31:52.644Z"      }    ],    "updatedAt": "2026-09-17T11:00:11.080Z",    "canEdit": true  }}

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.

Update brand kit PUT

Replace the brand guidance markdown. Owner only.