List saved description styles
The workspace's saved styles for POST /posts/description, and which one is used when none is named. A style has tone, length (short, medium, long), hashtags (how many, 0 to 10), emojis, language (auto writes in the language spoken in the clip), instructions (free text the AI follows) and template (how the parts are laid out with {{hook}}, {{body}}, {{cta}}, {{hashtags}} and {{title}}; empty uses the default).
apiKeyX-Api-Key<token>Response for status 200
application/json- response
presets*array<>default_preset_id*string|null|nullcurl -X GET 'https://api.cut.pro/api/v1/posts/description/presets'{ "presets": [ { "id": "string", "name": "string", "style": { "tone": "auto", "length": "short", "hashtags": 0, "emojis": true, "language": "auto", "instructions": "string", "template": "string" } } ], "default_preset_id": null}Write the post description with AI POST
Writes the text that goes with the post (caption, description, title) from what is said in the clip (`edit_id`), the images (`image_ids`) or a `title`, for each network in `platforms`, ready to drop in the `metadata` of `POST /posts`. Nothing is saved or posted. The style is `style` when sent, otherwise the saved preset `preset_id`, otherwise the workspace's default preset, otherwise CutPro's default. With `prompt`, the text follows that request instead of the style, rewriting `current_text` when given. Charged in credits by the size of the material, usually 0 or 1; `credits_charged` says how much. `422 CAPTION_NO_CONTEXT` when there is nothing to write from: a clip without speech, no images and no title or instructions.
Replace saved description styles PUT
Replaces the whole list at once. `400 INVALID_PRESETS` when two presets share an `id` or `default_preset_id` is not in the list.