Draft a post from a brief with AI
Draft a post from a brief with AI (posts:write)
Every request sends Authorization: Bearer ...: the access token in local mode, an API key stk_... in cloud mode. Use Send to try it against your cloud instance with your API key.
POST
The composer's Write with AI. The assistant's model (no tools) writes a title, the post and, for a thread, the comments under it, and with image a description of a picture for the generate operation. Nothing is saved. Counts as AI usage.
header
AuthorizationBearer <token>API key (stk_...), or in the Community Edition the access token (stk_local_...)
application/json- body
brief*stringWhat the post is about, in any words
Length
length <= 4000format?stringDefault
"short"Value in
"short""long""thread"voice?stringpersonal: I, brand: we
Default
"personal"Value in
"personal""brand""neutral"tone?stringDefault
"friendly"Value in
"friendly""professional""witty""bold""informative"max_chars?integerThe shortest character limit of the picked channels (0 = none)
Range
0 <= valueimage?booleanAlso describe a picture to go with the post (image_prompt)
OK
application/json- response
title*stringcontent*stringcomments*array<string>image_prompt?stringcurl -X POST 'https://staqly.example.com/v1/ai/post' \ -H 'Content-Type: application/json' \ -d '{ "brief": "string"}'Example Response
{ "title": "string", "content": "string", "comments": [ "string" ], "image_prompt": "string"}