Manage Videos

Trigger Smart actions

Changed on

Queues Smart Actions (title, description, chapters and/or moments generation) for a video that already has captions. This endpoint does not check the video library's Smart Actions setting — requests are accepted, processed and billed for transcription usage even when Smart Actions is disabled for the library. Requires at least one of GenerateTitle, GenerateDescription, GenerateChapters or GenerateMoments, and returns 429 once the library's Smart Actions usage threshold for the video is exceeded.

post/library/{libraryId}/videos/{videoId}/smart

Request

Path parameters

libraryIdinteger required

The ID of the video library.

videoIdstring required

The GUID of the video.

Request body

generateTitleboolean nullable

Whether video title should be generated.

generateDescriptionboolean nullable

Whether video description should be generated.

generateChaptersboolean nullable

Whether video chapters should be generated.

generateMomentsboolean nullable

Whether video moments should be generated.

sourceLanguagestring nullable

(Optional) Video source language, use ISO 639-1 language code.

Response

The smart action was queued

successboolean

Determines if the request was successful

messagestring nullable

Human-readable message describing the result, typically populated with error details when Success is false.

statusCodeinteger

The HTTP status code corresponding to the result of the request.

Changes