Poko API
Videos

Steer video

POST
/api/workspaces/{workspaceId}/videos/{videoId}/steer

Send a message to a video while it is being made. The app must be online.

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.

videoId*string

Video id: requestId from create_video, continue_video or list_videos.

Request Body

application/json
  1. body
message*string
Length1 <= length <= 20000

Response Body

Success

application/json
  1. response
success?boolean
data?
Example Request
curl -X POST 'https://api.poko.video/api/workspaces/string/videos/string/steer' \  -H 'Content-Type: application/json' \  -d '{  "message": "Use our green brand color for the headings."}'
Example Response
{  "success": true,  "data": {    "requestId": "3f9c2a71-5b8e-4d2a-9c41-7e6b0d5a8f12",    "steered": true  }}