Poko: AI Screen Recorder & Video Studio with an Editing Assistant

GET

/api/workspaces/{workspaceId}/settings

GET

/api/workspaces/{workspaceId}/settings

How videos are made in this workspace: voice, voiceover/music/sound effects, design pass, extra instructions and MCP servers. Voice API keys and MCP headers are never returned.

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

response

success?boolean

data?

Example Request

curl -X GET 'https://api.poko.video/api/workspaces/string/settings'

Example Request

curl -X GET 'https://api.poko.video/api/workspaces/string/settings'

Example ResponseSchema

{
  "success": true,
  "data": {
    "settings": {
      "customMcpServers": [
        {
          "enabled": true,
          "id": "mcp_k3v8q2xa",
          "name": "Docs MCP",
          "transport": "http",
          "url": "https://mcp.example.com/mcp"
        }
      ],
      "duckMusic": true,
      "elevenLabsVoiceModel": "eleven_v3",
      "extraSystemPrompt": "Keep scenes short and use our brand colors.",
      "generateMusic": true,
      "generateSfx": true,
      "generateVoiceover": true,
      "runDesignPass": false,
      "showBeatSheet": false,
      "vocalLabVoiceModel": "v-studio",
      "voiceProvider": "poko",
      "voiceSelections": {
        "cartesia": {
          "id": "5d1e7c2a-9b4f-4a3e-8c6d-2f1a0b9e8d7c",
          "language": "en",
          "locale": "en-US",
          "name": "Skylar"
        },
        "elevenlabs": {
          "id": "Xk29PqLm7RtVb3NcWe8A",
          "language": "",
          "locale": "",
          "name": "Bella - Professional, Bright, Warm"
        },
        "poko": {
          "id": "8e2b4c6d-1a3f-4e5b-9c7d-0f2e4a6b8c1d",
          "language": "en",
          "locale": "en-US",
          "name": "Daniel"
        },
        "vocallab": {
          "id": "",
          "language": "",
          "locale": "",
          "name": ""
        }
      },
      "cartesiaVoiceApiKey": "",
      "elevenLabsVoiceApiKey": "",
      "vocalLabVoiceApiKey": ""
    },
    "voiceKeys": {
      "cartesia": false,
      "elevenlabs": true,
      "vocallab": false
    },
    "canEdit": true,
    "updatedAt": "2026-11-04T21:29:54.815Z",
    "updatedBy": "user_2Nf7QxKp4TzLm9WbRc3HvYd8EaJ"
  }
}

{  "success": true,  "data": {    "settings": {      "customMcpServers": [        {          "enabled": true,          "id": "mcp_k3v8q2xa",          "name": "Docs MCP",          "transport": "http",          "url": "https://mcp.example.com/mcp"        }      ],      "duckMusic": true,      "elevenLabsVoiceModel": "eleven_v3",      "extraSystemPrompt": "Keep scenes short and use our brand colors.",      "generateMusic": true,      "generateSfx": true,      "generateVoiceover": true,      "runDesignPass": false,      "showBeatSheet": false,      "vocalLabVoiceModel": "v-studio",      "voiceProvider": "poko",      "voiceSelections": {        "cartesia": {          "id": "5d1e7c2a-9b4f-4a3e-8c6d-2f1a0b9e8d7c",          "language": "en",          "locale": "en-US",          "name": "Skylar"        },        "elevenlabs": {          "id": "Xk29PqLm7RtVb3NcWe8A",          "language": "",          "locale": "",          "name": "Bella - Professional, Bright, Warm"        },        "poko": {          "id": "8e2b4c6d-1a3f-4e5b-9c7d-0f2e4a6b8c1d",          "language": "en",          "locale": "en-US",          "name": "Daniel"        },        "vocallab": {          "id": "",          "language": "",          "locale": "",          "name": ""        }      },      "cartesiaVoiceApiKey": "",      "elevenLabsVoiceApiKey": "",      "vocalLabVoiceApiKey": ""    },    "voiceKeys": {      "cartesia": false,      "elevenlabs": true,      "vocallab": false    },    "canEdit": true,    "updatedAt": "2026-11-04T21:29:54.815Z",    "updatedBy": "user_2Nf7QxKp4TzLm9WbRc3HvYd8EaJ"  }}

Get settings

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Path Parameters

Response Body