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

Request Body

application/json

body

name*string

Length1 <= length <= 100

Response Body

The new collection.

application/json

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 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 ResponseSchema

{
  "data": {
    "id": "3c7a9e21-5b4d-4f8e-a1c2-7d9e0f1a2b3c",
    "name": "Arabic grammar, level 1",
    "video_ids": [],
    "created_at": "2026-10-25T09:30:00Z"
  }
}

{  "data": {    "id": "3c7a9e21-5b4d-4f8e-a1c2-7d9e0f1a2b3c",    "name": "Arabic grammar, level 1",    "video_ids": [],    "created_at": "2026-10-25T09:30:00Z"  }}

Create a collection

Authorizationنسخ رابط القسم

Header Parametersنسخ رابط القسم

Request Bodyنسخ رابط القسم

Response Bodyنسخ رابط القسم

Authorization

Header Parameters

Request Body

Response Body