Poko API
Brand kit

Sign brand asset upload

POST
/api/workspaces/{workspaceId}/brand-kit/files/sign

Step 1 of adding a brand file: get a link to PUT the file to (send the returned headers). Then call add_brand_asset. Owner only.

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.

Request Body

application/json
  1. body
fileName*string
Length1 <= length <= 500
contentType*string

MIME type, e.g. image/png.

Response Body

Success

application/json
  1. response
success?boolean
data?
Example Request
curl -X POST 'https://api.poko.video/api/workspaces/string/brand-kit/files/sign' \  -H 'Content-Type: application/json' \  -d '{  "fileName": "logo.png",  "contentType": "image/png"}'
Example Response
{  "success": true,  "data": {    "presignedUrl": "https://examplestorage.blob.core.windows.net/assets/ai-ads/w/Wk7pQ2xR/brand-kit/019a5f40-2c11-7d3e-8b9a-4f5e6d7c8b9a.png?sv=2025-05-05&spr=https&st=2026-11-05T09%3A59%3A00Z&se=2026-11-05T10%3A10%3A00Z&sr=b&sp=racw&sig=EXAMPLE_SIGNATURE",    "key": "ai-ads/w/Wk7pQ2xR/brand-kit/019a5f40-2c11-7d3e-8b9a-4f5e6d7c8b9a.png",    "publicUrl": "https://cdn.example.com/ai-ads/w/Wk7pQ2xR/brand-kit/019a5f40-2c11-7d3e-8b9a-4f5e6d7c8b9a.png",    "path": "/ai-ads/w/Wk7pQ2xR/brand-kit/019a5f40-2c11-7d3e-8b9a-4f5e6d7c8b9a.png",    "headers": {      "Content-Type": "image/png",      "x-ms-blob-type": "BlockBlob",      "x-ms-blob-cache-control": "public, max-age=31536000, immutable"    }  }}