Brand kit
Add brand asset
POST
Step 2 of adding a brand file, after the upload. Owner only.
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
name?stringDisplay name. Defaults to the file name.
Length
length <= 120fileName*stringLength
1 <= length <= 500path*stringpath from sign_brand_asset_upload.
url?stringpublicUrl from sign_brand_asset_upload.
mimeType*stringsizeBytes*integerRange
0 <= value <= 15728640Success
application/json- response
success?booleandata?curl -X POST 'https://api.poko.video/api/workspaces/string/brand-kit/files' \ -H 'Content-Type: application/json' \ -d '{ "name": "Logo", "fileName": "logo.png", "path": "/ai-ads/w/Wk7pQ2xR/brand-kit/019a5f40-2c11-7d3e-8b9a-4f5e6d7c8b9a.png", "url": "https://cdn.example.com/ai-ads/w/Wk7pQ2xR/brand-kit/019a5f40-2c11-7d3e-8b9a-4f5e6d7c8b9a.png", "mimeType": "image/png", "sizeBytes": 48213}'Example Response
{ "success": true, "data": { "file": { "id": "Td3kVb9NsR-e", "type": "asset", "createdBy": "user_2Nf7QxKp4TzLm9WbRc3HvYd8EaJ", "name": "Wordmark", "originalFileName": "acme-wordmark.png", "path": "/ai-ads/w/Wk7pQ2xR/brand-kit/019a5f40-2c11-7d3e-8b9a-4f5e6d7c8b9a.png", "url": "https://cdn.example.com/ai-ads/w/Wk7pQ2xR/brand-kit/019a5f40-2c11-7d3e-8b9a-4f5e6d7c8b9a.png", "mimeType": "image/png", "sizeBytes": 48211, "createdAt": "2026-11-05T10:01:12.004Z" }, "markdown": "# Acme brand\n\n- Primary color: #4F46E5", "files": [ { "id": "Td3kVb9NsR-e", "type": "asset", "createdBy": "user_2Nf7QxKp4TzLm9WbRc3HvYd8EaJ", "name": "Wordmark", "originalFileName": "acme-wordmark.png", "path": "/ai-ads/w/Wk7pQ2xR/brand-kit/019a5f40-2c11-7d3e-8b9a-4f5e6d7c8b9a.png", "url": "https://cdn.example.com/ai-ads/w/Wk7pQ2xR/brand-kit/019a5f40-2c11-7d3e-8b9a-4f5e6d7c8b9a.png", "mimeType": "image/png", "sizeBytes": 48211, "createdAt": "2026-11-05T10:01:12.004Z" } ], "updatedAt": "2026-11-05T10:01:12.004Z", "canEdit": true }}