---
title: "Trigger Smart actions"
method: POST
path: "/library/{libraryId}/videos/{videoId}/smart"
tags: ["Manage Videos"]
---

# Trigger Smart actions

`POST /library/{libraryId}/videos/{videoId}/smart`

## Request

- Base URL: `https://video.bunnycdn.com`
- URL: `https://video.bunnycdn.com/library/{libraryId}/videos/{videoId}/smart`
- Auth: API key in header `AccessKey`

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.

## Path parameters

- `libraryId` integer, required
- `videoId` string, required

## Request body

- SmartGenerateModel
  - `generateTitle` boolean, nullable: Whether video title should be generated.
  - `generateDescription` boolean, nullable: Whether video description should be generated.
  - `generateChapters` boolean, nullable: Whether video chapters should be generated.
  - `generateMoments` boolean, nullable: Whether video moments should be generated.
  - `sourceLanguage` string, nullable: (Optional) Video source language, use ISO 639-1 language code.

## Response `202`

The smart action was queued

- StatusModel
  - `success` boolean: Determines if the request was successful
  - `message` string, nullable: Human-readable message describing the result, typically populated with error details when Success is false.
  - `statusCode` integer: The HTTP status code corresponding to the result of the request.

## Other responses

- `400`: Invalid request for smart feature
- `401`: The request authentication failed
- `403`: The request authorization failed
- `404`: The requested video was not found
- `429`: Limit exceeded
- `500`: Internal Server Error
- `503`: The smart action could not be queued; the requested features are marked as failed and the request can be retried

## Changes

- **2026-11-12** `83116184952f`: 1 info
  - added the non-success response with the status `503`

[Operation history](https://skmtc.dev/bunny/apis/stream-api/changes/library/:libraryId/videos/:videoId/smart/post.md)

---

[API](https://skmtc.dev/bunny/apis/stream-api.md) - [All operations](https://skmtc.dev/bunny/apis/stream-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bunny/apis/stream-api/revisions/83116184952f?raw)