POST `/v1/ai/recipes`

Create an AI posting recipe.

Баталгаажуулалт

API түлхүүрийг bearer token хэлбэрээр илгөэнэ үү. Түлхүүр нь links.edit эрхтэй байх ёстой бөгөөд үүнгүйгээр 404 биш, харин 403 алдаа буцааж татгалзах болно.

Таны байгууллагын дугаар орох газар

Энэ төгсгөлийн цэг нь JSON бие хэсэгт org_id-ийг талбар болгон авдаг.

Танай байгууллагын ID нь таны хяналтын самбар дээрх API түлхүүрийн дэлгэцэнд, түлхүүр өөрөө хажууд байрладаг. Энэ нь таны хийх дуудлага бүрт ижил ID байна.

Туршиж үзэх

Өнцөг хаалтанд байгаа бүх зүйлийг өөрийн утгаар солиж, түлхүүр санамж байрлуулагчийг хяналтын самбарынхаа түлхүүрээр сольж оруулна уу.

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

Та нэвтэрсэн байна уу? Таны хяналтын самбар дахь API консол нь таны бодит байгууллагын ID болон өөрийн түлхүүрийг автоматаар бөглөж, шууд ажиллаж буй API рүү хүсэлт илгээх тул та бодит хариуг харах боломжтой болно. Энэ төгсгөлийн цэгийг API консол дээр нээх

Дэлгэрэнгүй

⛔ 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.

Хүсэлтийн бие

Нэр	Төрөл	Заавал шаардлагатай	Энэ юу вэ
`name`	`string`	Тийм	—
`is_enabled`	`boolean`	Үгүй	—
`brief`	`string`	Үгүй	—
`tone`	`string`	Үгүй	—
`word_count`	`integer`	Үгүй	—
`language`	`string`	Үгүй	—
`posts_per_run`	`integer`	Үгүй	—
`provider`	`string`	Үгүй	—
`model_id`	`string`	Үгүй	—
`model_family`	`string`	Үгүй	—
`anchors`	`AiAnchor[]`	Үгүй	—
`anchor_policy`	`string<none, every_post, rotate>`	Үгүй	—
`link_set_id`	`string`	Үгүй	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>`	Үгүй	—
`cadence_hour_utc`	`integer`	Үгүй	—
`cadence_dow`	`integer`	Үгүй	—
`cadence_dom`	`integer`	Үгүй	—
`target_kind`	`string<none, sites, site_group, cms_targets>`	Үгүй	—
`target_sites`	`string[]`	Үгүй	—
`target_site_group_id`	`object`	Үгүй	—
`target_cms_target_ids`	`string[]`	Үгүй	—
`target_category`	`string`	Үгүй	—
`requires_capabilities`	`string[]`	Үгүй	—
`capability_policy`	`string<refuse, degrade, ask>`	Үгүй	—
`image_provider`	`string`	Үгүй	—
`image_model`	`string`	Үгүй	—
`featured_image`	`boolean`	Үгүй	—
`inline_image_count`	`integer`	Үгүй	—
`inline_placement`	`string<after_intro, between_sections, end>`	Үгүй	—
`image_style`	`string`	Үгүй	—
`publish_mode`	`string<draft, schedule, publish>`	Үгүй	—
`schedule_offset_hours`	`integer`	Үгүй	—
`schedule_stagger_minutes`	`integer`	Үгүй	—
`org_id`	`Uuid`	Үгүй	UUIDv7 identifier — sortable by creation time (docs/02 §8).

Хариу үйлдэл

Нэр	Төрөл	Заавал шаардлагатай	Энэ юу вэ
`id`	`Uuid`	Тийм	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`name`	`string`	Тийм	—
`is_enabled`	`boolean`	Тийм	—
`brief`	`string`	Үгүй	—
`tone`	`string`	Үгүй	—
`word_count`	`integer`	Үгүй	—
`language`	`string`	Үгүй	BCP-47, or empty for "the language the brief is written in".
`posts_per_run`	`integer`	Үгүй	⛔ 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`	Үгүй	Blank = whatever the funding route resolves to.
`model_id`	`string`	Үгүй	Blank = the newest verified model in the family.
`model_family`	`string`	Үгүй	—
`anchors`	`AiAnchor[]`	Үгүй	—
`anchor_policy`	`string<none, every_post, rotate>`	Үгүй	—
`link_set_id`	`string`	Үгүй	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>`	Тийм	—
`cadence_hour_utc`	`integer`	Үгүй	—
`cadence_dow`	`integer`	Үгүй	0 = Monday.
`cadence_dom`	`integer`	Үгүй	⛔ 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`	Үгүй	—
`last_run_at`	`object`	Үгүй	—
`target_kind`	`string<none, sites, site_group, cms_targets>`	Үгүй	—
`target_sites`	`string[]`	Үгүй	—
`target_site_group_id`	`object`	Үгүй	—
`target_cms_target_ids`	`string[]`	Үгүй	—
`target_category`	`string`	Үгүй	—
`requires_capabilities`	`string[]`	Үгүй	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>`	Үгүй	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`	Үгүй	—
`image_model`	`string`	Үгүй	—
`featured_image`	`boolean`	Үгүй	—
`inline_image_count`	`integer`	Үгүй	—
`inline_placement`	`string<after_intro, between_sections, end>`	Үгүй	—
`image_style`	`string`	Үгүй	—
`publish_mode`	`string<draft, schedule, publish>`	Тийм	⚖️ 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`	Үгүй	—
`schedule_stagger_minutes`	`integer`	Үгүй	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[]`	Үгүй	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`	Тийм	—
`updated_at`	`string`	Үгүй	—

Энэ төгсгөл цэгээс буцааж болох алдаанууд

401 · 403 · 422 · 429