---
title: "Generate a ready-to-post description and hashtags for a clip"
method: POST
path: "/api/videos/{id}/clips/{clip_id}/description"
tags: ["smart"]
---

# Generate a ready-to-post description and hashtags for a clip

`POST /api/videos/{id}/clips/{clip_id}/description`

## Request

- Base URL: `https://cliponit.app`
- URL: `https://cliponit.app/api/videos/{id}/clips/{clip_id}/description`
- 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`)

2-3 sentences with a hook on the first line, in the transcript language, plus 5-8 hashtags without `#`. Cached on the clip: a second call returns the same result without AI.

## Path parameters

- `id` string, uuid, required
- `clip_id` string, uuid, required

## Response `200`

Description

- object
  - `description` string, required
  - `hashtags` string[], required

## Other responses

- `404`: Resource not found or not owned by the user

---

[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)