Create an AI-generated draft post
Generates a post caption from a prompt and creates a draft post. Optionally attaches social profiles, brand kit context, a reusable hashtag library, and one AI-generated image.
Authorizations
Query Parameters
Ocoya workspace ID. Get one from GET /workspaces.
"cmayvq3hk00017apshay5qezu"
Body
Prompt describing the post Ocoya should generate. Minimum 10 characters.
10"Write a launch post for our new analytics dashboard."
Caption tone for the AI draft.
professional, friendly, educational, bold, founder_led "professional"
Target caption length for the AI draft.
short, medium, long, extra_long "medium"
Connected social profile IDs that should receive the post. Get IDs from GET /social-profiles.
Brand kit ID used for brand context. Get IDs from GET /brand-kits.
"cmayw38dz00047apsue9nw4tf"
Hashtag library ID used for hashtag context. Get IDs from GET /hashtag-libraries.
"cmayw7l5200067apsmz2tv7e8"
Whether to generate square image media for the AI draft.
true
Number of generated images when generateImage is true. Use 1 for a single image or 2-5 for a carousel.
1 <= x <= 53
Optional image URLs to use as visual references when generateImage is true. Ocoya uses these images for style, composition, layout, and subject guidance; they are not attached directly to the post.
Optional Studio design IDs to use as visual references when generateImage is true. Get IDs from GET /studio-templates.
Response
Queued. Returns immediately with status GENERATING; fetch the post later to see the completed draft.