🚀 Version 2.0 is now live! See our changelog for details
🚀 Version 2.0 is now live! See our changelog for details
curl --request POST \
--url https://api.tenbyte.io/v1/stream/libraries/{libraryId}/videos/pull \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Test video",
"description": "this is my description",
"url": "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4",
"metadata": [
{
"key": "note",
"value": "this value of note"
},
{
"key": "task",
"value": "this value of task"
}
],
"tags": [
"trending",
"viral"
],
"folder_id": "8946e490-2cf3-48d2-82ae-99ab8e65a795"
}
'{
"data": {
"updated_at": "2025-11-10T14:51:04.93815986+06:00",
"created_at": "2025-11-09T11:38:37.855064+06:00",
"assets": {
"thumbnails": {
"preview_url": "https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/preview.webp",
"sprite_vtt_url": "https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/sprite.vtt",
"default_url": "https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/thumbnail.jpg",
"urls": [
"https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/thumbnail.jpg",
"https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/thumbnail_1.jpg",
"https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/thumbnail_2.jpg",
"https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/thumbnail_3.jpg",
"https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/thumbnail_4.jpg",
"https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/thumbnail_5.jpg"
]
},
"playback": {
"direct_play_url": "/stream/314221a1-3cbf-4d3c-846e-f6c22bc43064/default/44802b1a-cadf-40d0-92a8-24de96382402",
"hls_url": "https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/playlist.m3u8",
"dash_url": "https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/playlist.mpd",
"embed_url": "/stream/314221a1-3cbf-4d3c-846e-f6c22bc43064/default/44802b1a-cadf-40d0-92a8-24de96382402"
}
},
"folder_id": null,
"format": "abr",
"status": "created",
"description": "this is my description",
"name": "Test video update",
"resolutions": [
"240p",
"360p",
"480p",
"720p",
"1080p"
],
"tags": [
"trending",
"viral"
],
"metadata": [
{
"key": "note",
"value": "this value of note"
}
],
"size_bytes": 54321065,
"raw_size_bytes": 98765465,
"duration_seconds": 0,
"duration": 1265,
"organization_id": "a7f590b4-3fd7-42a4-82bb-a7cfa6aa9d04",
"id": "44802b1a-cadf-40d0-92a8-24de96382402",
"library_id": "314221a1-3cbf-4d3c-846e-f6c22bc43064"
},
"message": "Video Updated Successfully",
"success": true
}Uploads video directly under a library.
curl --request POST \
--url https://api.tenbyte.io/v1/stream/libraries/{libraryId}/videos/pull \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Test video",
"description": "this is my description",
"url": "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4",
"metadata": [
{
"key": "note",
"value": "this value of note"
},
{
"key": "task",
"value": "this value of task"
}
],
"tags": [
"trending",
"viral"
],
"folder_id": "8946e490-2cf3-48d2-82ae-99ab8e65a795"
}
'{
"data": {
"updated_at": "2025-11-10T14:51:04.93815986+06:00",
"created_at": "2025-11-09T11:38:37.855064+06:00",
"assets": {
"thumbnails": {
"preview_url": "https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/preview.webp",
"sprite_vtt_url": "https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/sprite.vtt",
"default_url": "https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/thumbnail.jpg",
"urls": [
"https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/thumbnail.jpg",
"https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/thumbnail_1.jpg",
"https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/thumbnail_2.jpg",
"https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/thumbnail_3.jpg",
"https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/thumbnail_4.jpg",
"https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/thumbnail_5.jpg"
]
},
"playback": {
"direct_play_url": "/stream/314221a1-3cbf-4d3c-846e-f6c22bc43064/default/44802b1a-cadf-40d0-92a8-24de96382402",
"hls_url": "https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/playlist.m3u8",
"dash_url": "https://example.com/44802b1a-cadf-40d0-92a8-24de96382402/playlist.mpd",
"embed_url": "/stream/314221a1-3cbf-4d3c-846e-f6c22bc43064/default/44802b1a-cadf-40d0-92a8-24de96382402"
}
},
"folder_id": null,
"format": "abr",
"status": "created",
"description": "this is my description",
"name": "Test video update",
"resolutions": [
"240p",
"360p",
"480p",
"720p",
"1080p"
],
"tags": [
"trending",
"viral"
],
"metadata": [
{
"key": "note",
"value": "this value of note"
}
],
"size_bytes": 54321065,
"raw_size_bytes": 98765465,
"duration_seconds": 0,
"duration": 1265,
"organization_id": "a7f590b4-3fd7-42a4-82bb-a7cfa6aa9d04",
"id": "44802b1a-cadf-40d0-92a8-24de96382402",
"library_id": "314221a1-3cbf-4d3c-846e-f6c22bc43064"
},
"message": "Video Updated Successfully",
"success": true
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Unique identifier of the library.
Source URL of the uploaded or external video file.
The title or display name of the video.
Short summary or context about the video content.
Optional list of tags or labels for categorizing the video.
ID of the folder under which this video will be created. Use null to store it directly in the library root.
Show child attributes
Show child attributes