Upsert Chapter

Designing

PUT

/v1/libraries/{libraryId}/videos/{videoId}/chapters

Create or update a chapter within a video.
If the chapter exists, it will be updated; otherwise, a new one will be created.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Not Found

🟠422Unprocessable Entity

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api-staging.tenbyte.io/v1/v1/libraries/314221a1-3cbf-4d3c-846e-f6c22bc43064/videos/33273fe3-0d29-45d5-a34b-b93eaca6543c/chapters' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "chapters": [
    {
      "title": "Introduction",
      "start_time": 1,
      "end_time": 30,
      "order_index": 0
    },
    {
      "title": "What is CDN?",
      "start_time": 30,
      "end_time": 60,
      "order_index": 1
    },
    {
      "title": "Next Steps",
      "start_time": 60,
      "end_time": 70
    }
  ]
}'

Response Example

200 - Success

{
    "data": [
        {
            "id": "03061150-2c72-40e4-9ac5-e5cd16083292",
            "video_id": "7f7a8d67-d552-4436-bc0e-1fdc62b9210a",
            "title": "Introduction",
            "start_time": 1,
            "end_time": 30,
            "order_index": 0
        },
        {
            "id": "3fc10b86-56c6-414c-ae5e-2ae40ecb15da",
            "video_id": "7f7a8d67-d552-4436-bc0e-1fdc62b9210a",
            "title": "What is Vidinfra CDN?",
            "start_time": 30,
            "end_time": 60,
            "order_index": 1
        },
        {
            "id": "e8835784-3410-435b-b075-c8834112c6dd",
            "video_id": "7f7a8d67-d552-4436-bc0e-1fdc62b9210a",
            "title": "Next Steps",
            "start_time": 60,
            "end_time": 70,
            "order_index": 2
        }
    ],
    "message": "Video Chapters Updated Successfully",
    "success": true
}

Modified at 2025-11-18 09:08:11

Mark Player As Default

List Chapter