ai

PATCH /v1/ai/recipes/{recipeId}

Edit an AI posting recipe.

ចំណុចបញ្ចប់ ai ទាំងអស់

ការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវ

បញ្ជូនសោ API ជា bearer token។ សោនេះត្រូវតែមានសិទ្ធិ links.edit។ សោដែលគ្មានសិទ្ធិនេះនឹងត្រូវបដិសេធដោយកូដ 403 មិនមែន 404 ទេ។

កន្លែងដែលលេខសម្គាល់អង្គការរបស់អ្នកត្រូវដាក់

ចំនុចបញ្ចប់នេះទទួលយក org_id ជាវាលមួយនៅក្នុងតួ JSON។

លេខសម្គាល់អង្គការរបស់អ្នកស្ថិតនៅលើអេក្រង់គ្រាប់ចុច API ក្នុងផ្ទាំងគ្រប់គ្រងរបស់អ្នក នៅជាប់នឹងគ្រាប់ចុចផ្ទាល់តែម្ដង។ វាគឺជាលេខសម្គាល់ដូចគ្នានៅក្នុងការហៅទូរសព្ទនីមួយៗដែលអ្នកធ្វើ។

សាកល្បង

ជំនួសអ្វីមួយនៅក្នុងសញ្ញាពងក្រពើ < > ដោយប្រើតម្លៃផ្ទាល់ខ្លួនរបស់អ្នក ហើយជំនួសកន្លែងរក្សាទុកសោដោយប្រើសោចេញពីផ្ទាំងគ្រប់គ្រងរបស់អ្នក។

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

បានចូលគណនីរួចហើយមែនទេ? កុងសូល API ក្នុងផ្ទាំងគ្រប់គ្រងរបស់អ្នក បំពេញលេខសម្គាល់ស្ថាប័នពិតប្រាកដរបស់អ្នក និងសោផ្ទាល់ខ្លួនរបស់អ្នក ហើយដំណើរការសំណើទល់នឹង API ផ្ទាល់ ដូច្នេះអ្នកអាចមើលឃើញការឆ្លើយតបពិតប្រាកដ។ បើកចំណុចបញ្ចប់នេះក្នុងកុងសូល API

ព័ត៌មានលម្អិត

Partial update. The schedule is recomputed on every write rather than by a nightly job — a recipe saved with a cadence and no next run is a recipe that never runs and shows no error anywhere. Requires `links.edit`.

ប៉ារ៉ាម៉ែត្រ

ឈ្មោះប្រភេទតម្រូវការតើវាជាអ្វី
recipeId (path)Uuidបាទ/ចាស

សំណើរបស់រាងកាយ

ឈ្មោះប្រភេទតម្រូវការតើវាជាអ្វី
namestringបាទ/ចាស
is_enabledbooleanទេ
briefstringទេ
tonestringទេ
word_countintegerទេ
languagestringទេ
posts_per_runintegerទេ
providerstringទេ
model_idstringទេ
model_familystringទេ
anchorsAiAnchor[]ទេ
anchor_policystring<none, every_post, rotate>ទេ
link_set_idstringទេ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…
cadencestring<manual, daily, weekly, monthly>ទេ
cadence_hour_utcintegerទេ
cadence_dowintegerទេ
cadence_domintegerទេ
target_kindstring<none, sites, site_group, cms_targets>ទេ
target_sitesstring[]ទេ
target_site_group_idobjectទេ
target_cms_target_idsstring[]ទេ
target_categorystringទេ
requires_capabilitiesstring[]ទេ
capability_policystring<refuse, degrade, ask>ទេ
image_providerstringទេ
image_modelstringទេ
featured_imagebooleanទេ
inline_image_countintegerទេ
inline_placementstring<after_intro, between_sections, end>ទេ
image_stylestringទេ
publish_modestring<draft, schedule, publish>ទេ
schedule_offset_hoursintegerទេ
schedule_stagger_minutesintegerទេ
org_idUuidទេUUIDv7 identifier — sortable by creation time (docs/02 §8).

ផ្អាកដំណើរការ

ឈ្មោះប្រភេទតម្រូវការតើវាជាអ្វី
idUuidបាទ/ចាសUUIDv7 identifier — sortable by creation time (docs/02 §8).
namestringបាទ/ចាស
is_enabledbooleanបាទ/ចាស
briefstringទេ
tonestringទេ
word_countintegerទេ
languagestringទេBCP-47, or empty for "the language the brief is written in".
posts_per_runintegerទេ⛔ 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.
providerstringទេBlank = whatever the funding route resolves to.
model_idstringទេBlank = the newest verified model in the family.
model_familystringទេ
anchorsAiAnchor[]ទេ
anchor_policystring<none, every_post, rotate>ទេ
link_set_idstringទេ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…
cadencestring<manual, daily, weekly, monthly>បាទ/ចាស
cadence_hour_utcintegerទេ
cadence_dowintegerទេ0 = Monday.
cadence_domintegerទេ⛔ 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_atobjectទេ
last_run_atobjectទេ
target_kindstring<none, sites, site_group, cms_targets>ទេ
target_sitesstring[]ទេ
target_site_group_idobjectទេ
target_cms_target_idsstring[]ទេ
target_categorystringទេ
requires_capabilitiesstring[]ទេ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_policystring<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_providerstringទេ
image_modelstringទេ
featured_imagebooleanទេ
inline_image_countintegerទេ
inline_placementstring<after_intro, between_sections, end>ទេ
image_stylestringទេ
publish_modestring<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_hoursintegerទេ
schedule_stagger_minutesintegerទេMinutes between consecutive posts in one run. ⛔ Not cosmetic: a network whose articles all appear in the same minute is a footprint.
blocking_providersstring[]ទេ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_atstringបាទ/ចាស
updated_atstringទេ

កំហុសដែលចំណុចបញ្ចប់នេះអាចបង្វិលត្រឡប់មកវិញ

401 · 403 · 404 · 422 · 429