> ## Documentation Index
> Fetch the complete documentation index at: https://docs.knowlify.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> HTTP API for the Knowlify Video Generation Engine

## Overview

Knowlify exposes two HTTP endpoints for video generation — one to queue jobs, one to poll their progress:

<Columns cols={2}>
  <Card title="Create video" icon="video" href="/api-reference/create-video">
    `POST /v1/videos` — queue 1–50 jobs in one call. Async; returns job IDs to poll.
  </Card>

  <Card title="Poll video status" icon="loader" href="/api-reference/poll-video">
    `GET /v1/videos/{uuid}` — check render progress until `is_complete` is `true`.
  </Card>
</Columns>

The flow is async by design — `POST /v1/videos` accepts a batch and returns job IDs immediately, while rendering happens in the background. Poll `GET /v1/videos/{uuid}` for status, or subscribe to Supabase realtime updates on the returned `uuid` for live progress.

## Shared guides

<Columns cols={3}>
  <Card title="Authentication" icon="key" href="/api-reference/authentication">
    `X-API-Key` issuance, rotation, and scope rules.
  </Card>

  <Card title="Rate Limits" icon="gauge" href="/api-reference/rate-limits">
    30 req/min, 1–50 items per call, 3 concurrent jobs.
  </Card>

  <Card title="Errors" icon="circle-exclamation" href="/api-reference/errors">
    HTTP status codes and per-item error shapes.
  </Card>
</Columns>

## Getting started

1. Open the **Developer** tab in your dashboard and generate an API key.
2. Read the [Authentication](/api-reference/authentication) guide for the header format.
3. Make your first call using the curl or JavaScript snippet on the [Create video](/api-reference/create-video) page.
4. [Poll video status](/api-reference/poll-video) (or subscribe via Supabase realtime) until `is_complete` is `true`.