API overview

The Yuzu API lets you create and manage video-generation flows from your own systems — typically to wire Yuzu into a CRM, automation, or notetaker pipeline.

Base URL

https://app.yuzulabs.io/api/v1

Authentication

All endpoints require a Bearer token in the Authorization header:

Authorization: Bearer yzlk_your_api_key_here

API keys start with yzlk_ and are created from Settings → API Keys in your Yuzu workspace. Keys are scoped to a single workspace and can be restricted to specific operations (see Scopes below).

Treat keys as secrets. They grant access to your workspace’s data and quota. Rotate immediately if exposed.

Scopes

Scope	What it allows
`flows:create`	Start new flows.
`flows:read`	Read flow status, scripts, and rendered video URLs.
`flows:approve`	Approve, edit, or reject scripts when manual approval is enabled.
`flows:cancel`	Cancel an in-progress flow.
`*`	All of the above.

Errors

Errors return a JSON body with a stable code:

{
  "success": false,
  "error": "Email content must be at least 50 words",
  "code": "VALIDATION_ERROR"
}

Status	Code	Meaning
400	`VALIDATION_ERROR`	Request body failed validation.
401	`INVALID_API_KEY`	Missing or invalid API key.
403	`INSUFFICIENT_SCOPE`	Key doesn’t have the required scope.
404	`FLOW_NOT_FOUND`	The flow ID doesn’t exist or isn’t in your workspace.
429	`QUOTA_EXCEEDED`	Workspace video quota reached.
5xx	`INTERNAL_ERROR`	Transient — retry with exponential backoff.

Available flows

Sales Email Video Flow

60–70 second follow-up videos generated from a sales-call summary email.

Overview

Flows

API overview

Base URL

Authentication

Scopes

Errors

Available flows

Sales Email Video Flow

​Base URL

​Authentication

​Scopes

​Errors

​Available flows

Sales Email Video Flow

Base URL

Authentication

Scopes

Errors

Available flows