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

Edit an AI posting recipe.

ავტორიზაცია

API გასაღები გაგზავნეთ როგორც მატარებელი ტოკენი (bearer token). გასაღებს უნდა ჰქონდეს links.edit ნებართვა; ამის გარეშე გასაღები უარყოფილი იქნება 403 და არა 404 სტატუსით.

სwhere your organisation id goes-ის ადგილი

ესენდპოინტი იღებს org_id-ს JSON ტანის ველად.

თქვენი ორგანიზაციის ID მითითებულია თქვენი სამართავი პანელის API გასაღებების ეკრანზე, თავად გასაღებთან ახლოს. ის ერთნაირია თქვენ მიერ განხორციელებულ ყველა გამოძახებაში.

სცადეთ

შეSubstituted any value inside angle brackets with your own and the key placeholder with a key from your dashboard.

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 კონსოლი ავტომატურად ამატებს თქვენი რეალური ორგანიზაციის ID-სა და საკუთარ გასაღებს და ატარებს მოთხოვნას ცოცხალ API-ს წინააღმდეგ, რათა იხილოთ რეალური პასუხი. გაAღით ეს ენდპოინტი 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`	დიახ	—

მოთხოვნის სხეული

სახელი	ტიპი	სავალდებულო	რა არის ეს
`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 · 404 · 422 · 429

PATCH /v1/ai/recipes/{recipeId}