---
title: "AI suggestions of B-roll moments for the clip"
method: POST
path: "/api/clips/{id}/broll/suggest"
tags: ["smart"]
---

# AI suggestions of B-roll moments for the clip

`POST /api/clips/{id}/broll/suggest`

## Request

- Base URL: `https://cliponit.app`
- URL: `https://cliponit.app/api/clips/{id}/broll/suggest`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `session`
  - OAuth 2 (authorization code, authorization URL `https://cliponit.app/oauth/authorize`, token URL `https://cliponit.app/oauth/token`, scopes: `clips`)

≤ 3 moments `{start, end, query}` (2-5 s each, absolute seconds, English 2-4 word query). Nothing is applied: call `searchBroll` then `addBroll`.

## Path parameters

- `id` string, uuid, required

## Response `200`

Suggestions

- object
  - `suggestions` object[], required
    - `start` number, required
    - `end` number, required
    - `query` string, required

## Other responses

- `403`: Feature not included in the user's plan (upgrade at /billing)

---

[API](https://skmtc.dev/cliponit/apis/cliponit-api.md) · [All operations](https://skmtc.dev/cliponit/apis/cliponit-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cliponit/apis/cliponit-api/revisions/10e3e4327922?raw)