Poko API
Videos

Get app status

GET
/api/workspaces/{workspaceId}/app-status

Whether the Poko app on the person's computer is connected. New videos wait in a queue while it is closed.

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.

Response Body

Success

application/json
  1. response
success?boolean
data?
Example Request
curl -X GET 'https://api.poko.video/api/workspaces/string/app-status'
Example Response
{  "success": true,  "data": {    "online": true,    "openWorkspace": {      "id": "Wk7pQ2xR",      "name": "Acme Studio"    }  }}

List workspaces GET

Workspaces this key can use. Videos are made in the one open in the person's Poko app (openInApp).

Create video POST

Start making a video in the Poko app, with the app's own AI and the workspace settings. Returns at once with the queued video's `requestId`; poll Get video until `status` is `completed` or `failed`. While the app is closed the video waits in a queue.