Poko API
Brand kit

Rename brand asset

PATCH
/api/workspaces/{workspaceId}/brand-kit/files/{fileId}

Rename a brand file. 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.

fileId*string

Brand file id, from get_brand_kit.

Request Body

application/json
  1. body
name*string
Length1 <= length <= 120

Response Body

Success

application/json
  1. response
success?boolean
data?
Example Request
curl -X PATCH 'https://api.poko.video/api/workspaces/string/brand-kit/files/string' \  -H 'Content-Type: application/json' \  -d '{  "name": "Logo (dark)"}'
Example Response
{  "success": true,  "data": {    "file": {      "id": "Fq8LmZp2Xc_W",      "type": "asset",      "createdBy": "user_2Nf7QxKp4TzLm9WbRc3HvYd8EaJ",      "name": "Primary logo",      "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"    },    "markdown": "# Acme brand",    "files": [      {        "id": "Fq8LmZp2Xc_W",        "type": "asset",        "createdBy": "user_2Nf7QxKp4TzLm9WbRc3HvYd8EaJ",        "name": "Primary logo",        "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:03:30.551Z",    "canEdit": true  }}