Skip to main content
POST
/
libraries
Create Library
curl --request POST \
  --url https://api.tenbyte.io/v1/stream/libraries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Product Launch Video",
  "usage_type": "marketing",
  "description": "Videos for product launches and announcements.",
  "default_privacy": "unlisted",
  "tags": [
    "product",
    "launch",
    "marketing"
  ]
}
'
{
  "data": {
    "updated_at": "2025-10-16T10:28:09.121621765+06:00",
    "created_at": "2025-10-16T10:28:09.121621765+06:00",
    "created_by": "2fa3fe27-ffcd-470b-becf-83f6f22a93ab",
    "updated_by": null,
    "deleted_at": null,
    "region": "us-east-1",
    "description": "Videos for product launches and announcements.",
    "default_privacy": "unlisted",
    "tags": [
      "product",
      "launch",
      "marketing"
    ],
    "status": "provisioning",
    "usage_type": "marketing",
    "name": "Product Launch Videos",
    "security": {
      "whitelist_referrer_policy": null,
      "black_country_policy": null
    },
    "id": "ab0507fa-3020-4cfa-8f6a-a5864e65f06c",
    "distribution_id": "00000000-0000-0000-0000-000000000000",
    "organization_id": "677826f5-1aea-4cba-8973-043cdbc60f35"
  },
  "message": "Library Created Successfully",
  "success": true
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string
required

The display name of the library. This identifies the library.

​
region
string
required

Deployment region or storage zone for the library.

​
usage_type
string
required

Defines how the library will be used.

​
description
string

Short summary of what this library is used for.

​
default_privacy
string

Sets the default privacy mode for uploaded assets.

​
tags
string[]

List of labels or keywords to categorize and quickly filter libraries (e.g., ["marketing", "training", "internal"]).

Response

​
data
object
required
​
message
string
required
​
success
boolean
required