POST `/v1/ai/recipes`

Create an AI posting recipe.

Kimlik Doğrulama

Bearer token olarak bir API anahtarı gönderin. Anahtar links.edit iznine sahip olmalıdır; bu izne sahip olmayan bir anahtar 404 ile değil, 403 ile reddedilir.

Kurum kimliğinizin yazılacağı yer

Bu uç nokta, JSON gövdesinde bir alan olarak org_id alır.

Kuruluş kimliğiniz (id), kontrol panelinizdeki API anahtarları ekranında, anahtarın hemen yanında yer alır. Yaptığınız her çağrıda aynı kimlik kullanılır.

Dene

Köşeli parantez içindeki her şeyi kendi değerlerinizle ve anahtar yer tutucusunu panonuzdan bir anahtarla değiştirin.

curl -X POST https://api.zinndigital.com/v1/ai/recipes \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "name": <string> }'

Oturum açtınız mı? Panonuzdaki API konsolu, gerçek organizasyon kimliğinizi ve kendi anahtarınızı otomatik olarak doldurur ve isteği canlı API üzerinde çalıştırarak gerçek yanıtı görmenizi sağlar. Bu uç noktayı API konsolunda açın

Ayrıntılar

⛔ Bounds are enforced at **authoring** time, not at run time: more than five anchors or more than ten posts per run would be refused on every run, so a recipe saved with them would look fine, sit on a schedule, and fail silently every night. Requires `links.edit` — the same key as writing a post by hand, because that is what this is.

İstek gövdesi

Ad	Tür	Zorunlu	Ne olduğu
`name`	`string`	Evet	—
`is_enabled`	`boolean`	Hayır	—
`brief`	`string`	Hayır	—
`tone`	`string`	Hayır	—
`word_count`	`integer`	Hayır	—
`language`	`string`	Hayır	—
`posts_per_run`	`integer`	Hayır	—
`provider`	`string`	Hayır	—
`model_id`	`string`	Hayır	—
`model_family`	`string`	Hayır	—
`anchors`	`AiAnchor[]`	Hayır	—
`anchor_policy`	`string<none, every_post, rotate>`	Hayır	—
`link_set_id`	`string`	Hayır	The reusable link set this recipe draws its links from, or `null` to use the recipe's own `anchors`. When set it replaces `anchors` rather than adding to them — two sources…
`cadence`	`string<manual, daily, weekly, monthly>`	Hayır	—
`cadence_hour_utc`	`integer`	Hayır	—
`cadence_dow`	`integer`	Hayır	—
`cadence_dom`	`integer`	Hayır	—
`target_kind`	`string<none, sites, site_group, cms_targets>`	Hayır	—
`target_sites`	`string[]`	Hayır	—
`target_site_group_id`	`object`	Hayır	—
`target_cms_target_ids`	`string[]`	Hayır	—
`target_category`	`string`	Hayır	—
`requires_capabilities`	`string[]`	Hayır	—
`capability_policy`	`string<refuse, degrade, ask>`	Hayır	—
`image_provider`	`string`	Hayır	—
`image_model`	`string`	Hayır	—
`featured_image`	`boolean`	Hayır	—
`inline_image_count`	`integer`	Hayır	—
`inline_placement`	`string<after_intro, between_sections, end>`	Hayır	—
`image_style`	`string`	Hayır	—
`publish_mode`	`string<draft, schedule, publish>`	Hayır	—
`schedule_offset_hours`	`integer`	Hayır	—
`schedule_stagger_minutes`	`integer`	Hayır	—
`org_id`	`Uuid`	Hayır	UUIDv7 identifier — sortable by creation time (docs/02 §8).

Yanıt

Ad	Tür	Zorunlu	Ne olduğu
`id`	`Uuid`	Evet	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`name`	`string`	Evet	—
`is_enabled`	`boolean`	Evet	—
`brief`	`string`	Hayır	—
`tone`	`string`	Hayır	—
`word_count`	`integer`	Hayır	—
`language`	`string`	Hayır	BCP-47, or empty for "the language the brief is written in".
`posts_per_run`	`integer`	Hayır	⛔ Capped at 10. Two hundred articles from one brief are two hundred near-identical articles, which is a footprint — the exact thing the Footprint-Free line is sold to avoid.
`provider`	`string`	Hayır	Blank = whatever the funding route resolves to.
`model_id`	`string`	Hayır	Blank = the newest verified model in the family.
`model_family`	`string`	Hayır	—
`anchors`	`AiAnchor[]`	Hayır	—
`anchor_policy`	`string<none, every_post, rotate>`	Hayır	—
`link_set_id`	`string`	Hayır	The reusable link set this recipe draws its links from, or `null` to use the recipe's own `anchors`. When set it replaces `anchors` rather than adding to them — two sources…
`cadence`	`string<manual, daily, weekly, monthly>`	Evet	—
`cadence_hour_utc`	`integer`	Hayır	—
`cadence_dow`	`integer`	Hayır	0 = Monday.
`cadence_dom`	`integer`	Hayır	⛔ Never 29-31: a monthly recipe set to the 31st would skip February silently, and a schedule that stops without an error is the failure this feature prevents.
`next_run_at`	`object`	Hayır	—
`last_run_at`	`object`	Hayır	—
`target_kind`	`string<none, sites, site_group, cms_targets>`	Hayır	—
`target_sites`	`string[]`	Hayır	—
`target_site_group_id`	`object`	Hayır	—
`target_cms_target_ids`	`string[]`	Hayır	—
`target_category`	`string`	Hayır	—
`requires_capabilities`	`string[]`	Hayır	Capability ids the target must support, e.g. `cms_target:featured_image`. Enforced on every run: each site's capabilities are read from its CMS target and any shortfall is handl…
`capability_policy`	`string<refuse, degrade, ask>`	Hayır	What to do when a target cannot do something the recipe requires. Default `refuse` — silently dropping a requested field is the failure this exists to stop. `refuse` skips that…
`image_provider`	`string`	Hayır	—
`image_model`	`string`	Hayır	—
`featured_image`	`boolean`	Hayır	—
`inline_image_count`	`integer`	Hayır	—
`inline_placement`	`string<after_intro, between_sections, end>`	Hayır	—
`image_style`	`string`	Hayır	—
`publish_mode`	`string<draft, schedule, publish>`	Evet	⚖️ Owner ruling 2026-08-20: a per-recipe switch defaulting to `draft`. `draft` writes into the library and schedules nothing; `schedule` queues placements the customer can s…
`schedule_offset_hours`	`integer`	Hayır	—
`schedule_stagger_minutes`	`integer`	Hayır	Minutes between consecutive posts in one run. ⛔ Not cosmetic: a network whose articles all appear in the same minute is a footprint.
`blocking_providers`	`string[]`	Hayır	Providers this recipe needs a working key for and does not have. Empty means it can run now. ⚖️ A recipe naming no provider is never blocked — credits are the default route and…
`created_at`	`string`	Evet	—
`updated_at`	`string`	Hayır	—

Bu uç noktanın dönderebileceği hatalar

401 · 403 · 422 · 429