Poko API
Brand kit

Update brand kit

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

Replace the brand guidance markdown. 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
markdown*string

Response Body

Success

application/json
  1. response
success?boolean
data?
Example Request
curl -X PUT 'https://api.poko.video/api/workspaces/string/brand-kit' \  -H 'Content-Type: application/json' \  -d '{  "markdown": "# Acme Studio\n\n- Colors: #0F172A and #22C55E\n- Font: Inter\n- Tone: clear and friendly"}'
Example Response
{  "success": true,  "data": {    "markdown": "# Acme brand\n\n- Primary color: #4F46E5\n- Font: Inter",    "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-11-05T10:02:44.120Z",    "canEdit": true  }}