GET `/v1/ai/recipes/{recipeId}`

One AI posting recipe.

Kimlik Doğrulama

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

Bu uç nokta hiçbir organizasyon kimliği almaz. Anahtarınız zaten ait olduğu organizasyonu tanımlar ve yanıt bu organizasyonla sınırlandırı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 GET https://api.zinndigital.com/v1/ai/recipes/{recipeId} \
  -H "Authorization: Bearer zdk_live_…"

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

Requires `links.view`.

Parametreler

Ad	Tür	Zorunlu	Ne olduğu
`recipeId (path)`	`Uuid`	Evet	—

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 · 404 · 429

GET /v1/ai/recipes/{recipeId}