AI

Rewrite an existing caption

Rewrites originalText following the instruction in prompt. Send partialText to continue from a partly written caption. Costs the same as generating one.. Requires the ai.generate permission.

post/ai/captions/refine

Request

  • Base URL: https://post.adaptlypost.com/post/api/v1
  • URL: https://post.adaptlypost.com/post/api/v1/ai/captions/refine
  • Auth: HTTP bearer

Headers

X-Workspace-Idstring

The workspace to act in, for OAuth sign-ins that reach several workspaces. Take the id from GET /workspaces. Without it the call lands in the default workspace. A workspace the caller cannot reach answers 403 with code: workspace_access_denied. An API key belongs to one workspace: send its own id or leave the header out

Request body

promptstring required

How the caption should change

platform'TWITTER' | 'BLUESKY' | 'MASTODON' | 'THREADS' | 'PINTEREST' | 'INSTAGRAM' | 'TIKTOK' | 'LINKEDIN' | 'YOUTUBE' | 'FACEBOOK' | 'GOOGLE_BUSINESS' | 'TUMBLR'

Holds the caption to this platform's character limit

originalTextstring required

The caption to rewrite

partialTextstring

A partly written caption to continue from

Response

Rewritten caption

captionstring

Changes

No recorded changes to this operation across all 2 revisions of this API.