🚀 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 '
{
"url": "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4"
}
'{
"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 '
{
"url": "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4"
}
'{
"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.
Key–value pairs containing additional information or custom attributes for the video.
Show child attributes
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.