Draft: these docs describe OctaVideo as it will be at launch; some features may not be live yet.
OctaVideoDocs
API referenceCollections

Create a collection

POST
/collections

Creates an empty collection in the library.

Authorization

AccessKey
headerAccessKey<token>

The private key of a library, starting with ovk_. Copy it from API & embeds in the console, keep it on your server, and rotate it there if it leaks.

Header Parameters

AccessKey*string

The library's private key. Same value as the AccessKey security scheme; listed here so code samples include it.

Request Body

application/json
  1. body
name*string
Length1 <= length <= 100

Response Body

The new collection.

application/json
  1. response
data*
Example Request
curl -X POST 'https://api.octavideo.tech/api/v1/collections' \  -H 'AccessKey: ovk_YOUR_LIBRARY_PRIVATE_KEY' \  -H 'Content-Type: application/json' \  -d '{  "name": "Arabic grammar, level 1"}'
Example Response
{  "data": {    "id": "3c7a9e21-5b4d-4f8e-a1c2-7d9e0f1a2b3c",    "name": "Arabic grammar, level 1",    "video_ids": [],    "created_at": "2026-10-25T09:30:00Z"  }}

List video thumbnails GET

Returns the URLs of the thumbnails generated for a video. The list is empty until processing reaches the thumbnails stage.

Add videos to a collection POST

Adds 1 to 100 videos of the library to a collection. Video IDs must be unique within the request.