Docs
REST APIVideosSet chapters POST

Set chapters

Replaces all chapters for a video. The provided array fully overwrites existing chapters. Chapter start times must be greater than 0 and less than the video duration.

POST
/v1/videos/{id}/chapters

Authorization

BearerAuth
AuthorizationBearer <token>

Pass the raw API key as a Bearer token (Authorization: Bearer <key>). Publishable keys start with mvi_pub_ (playback-scoped). Other prefixes denote private/admin keys for general REST routes. GET /v1/embeds/{embedId}/playback accepts publishable keys only.

In: header

Path Parameters

id*string

Video UUID.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://api.moviie.ai/v1/videos/497f6eca-6276-4993-bfeb-53cbbbba6f08/chapters" \  -H "Content-Type: application/json" \  -d '{    "chapters": [      {        "title": "Introduction",        "start_time_seconds": 30      }    ]  }'
[
  {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "title": "Introduction",
    "start_time_seconds": 30,
    "order": 0,
    "generated_by_ai": true,
    "created_at": "string"
  }
]
{
  "error": "Resource not found",
  "code": "NOT_FOUND"
}
{
  "error": "Resource not found",
  "code": "NOT_FOUND"
}