Skip to main content
POST
Generate posts

Authorizations

Authorization
string
header
required

Bearer an mk_live_ API key. A key is ORG-SCOPED: it grants full access to every resource in that organization, with no per-endpoint scoping (see the uid pseudo-permission on each operation). Manage keys at https://app.mymarky.ai.

Headers

Marky-Version
enum<string>

Opt into a dated API version. Omit to stay on the floor (2026-04-08) forever — unpinned clients never break. Pin to a newer date (e.g. 2026-08-06) to receive the newest response shapes. Unknown values fall back to the floor. See https://docs.mymarky.ai for the versioning model.

Available options:
2026-04-08,
2026-07-17,
2026-08-02,
2026-08-04,
2026-08-06
Example:

"2026-08-06"

Path Parameters

business_id
string
required

A UUID identifier.

Body

application/json
content
string | null

Plain text content to generate posts from (used as the post topic).

website_url
string | null

URL to scrape for content context. The page text is used as input for generation.

custom_idea
string | null

Skip ideation and use this text directly as the post idea for all generated posts.

count
integer
default:1

Number of posts to generate (1-10).

Required range: 1 <= x <= 10
creative_formats
string[] | null

Which post formats to generate (round-robins across the list). One or more of: design, carousel, meme, image, gif, video, ai-image, ai-video. Omit to use the business's default mix.

ai_image_type
enum<string> | null

Sub-type for AI-image generation (only used when a creative_format is 'ai-image'): design, photo, infographic, or meme.

Available options:
design,
photo,
infographic,
meme
ai_image_style
string | null

Visual style modifier for AI images (e.g. 'corporate-flat', 'isometric', 'comic'). Only used for 'ai-image'.

template_ids
string[] | null

Restrict design generation to these specific template IDs instead of auto-selecting.

voice
string | null

Override the brand voice/tone for this generation only (the business's saved Profile is used when omitted).

include_stock
boolean | null

Whether stock photos (Unsplash/Pexels) may be used. Omit to use the business's saved preference.

aspect_ratio
string | null

Aspect ratio for generated media, e.g. '1:1' (square), '9:16' (story/reel), '4:5' (portrait). Omit for the business default.

Response

Generation job created

job_id
string
required

ID to poll for status

status
string
required

Current job status

data
PostResult · object[] | null

Generated posts (when status=completed)

error
string | null

Error message (when status=failed)