Write the post description with AI
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.
apiKeyX-Api-Key<token>- body
edit_id?stringEdit of the clip being posted; its speech is the main material
1 <= length <= 64image_ids?array<>Images of a photo post
items <= 10title?stringWhat the post is about, when there is no clip or as extra context
length <= 5000platforms*array<>Networks the text is for, e.g. tiktok, youtube
items <= 16style?preset_id?stringA preset from GET /posts/description/presets
length <= 64prompt?stringWhat to write, in your own words
length <= 1000current_text?stringText to rewrite with prompt
length <= 5000Response for status 200
application/json- response
text*stringThe description as one text, for networks that take a single caption
fields*Per network, each field of its metadata in POST /posts with its text
credits_charged*numbercurl -X POST 'https://api.cut.pro/api/v1/posts/description' \ -H 'Content-Type: application/json' \ -d '{ "platforms": [ "string" ]}'{ "text": "string", "fields": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "credits_charged": 0}Create a post POST
Creates a multi-platform post for one or more edited clips. Each entry under `videos` references an `edit_id` (the rendered or apply_template'd clip) plus a list of target connections with platform-specific metadata. `metadata` is the only part of this API that keeps each network's own field names (`privacyLevel`, `categoryId`, `privacyStatus`): they are forwarded to the network as-is, so renaming them here would only hide what actually goes out. Pass `scheduled_at` (ISO 8601, must be in the future) to schedule the post; omit it to publish immediately. Immediate posts kick off rendering + publishing in the background: poll `GET /posts/{id}` until every item is `completed` or `failed`. Failed items can be retried with `POST /posts/{id}/items/{itemId}/retry`. Networks still rolling out reject the whole request with `PLATFORM_UNAVAILABLE` before anything is created.
List saved description styles GET
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).