ai

GET /v1/ai/recipes/{recipeId}

One AI posting recipe.

सबै ai इन्डपइन्टहरू

प्रमाणीकरण

एपिआई कुञ्जीलाई बियरर टोकन (bearer token) को रूपमा पठाउनुहोस्। कुञ्जीसँग links.view अनुमति हुनुपर्छ; अनुमति नभएको कुञ्जीलाई 404 होइन, 403 मार्फत अस्वीकार गरिन्छ।

यो इन्डपोइन्टले कुनै संस्थाको आइडी लिँदैन। तपाईंको कुञ्जीले यस अन्तर्गत पर्ने संस्थालाई पहिल्यै पहिचान गर्छ, र प्रतिक्रिया त्यसैमा सीमित हुन्छ।

प्रयास गर्नुहोस्

कोणीय कोष्ठकभित्र भएका जुनसुकै कुरालाई आफ्नो मानहरूद्वारा बदल्नुहोस्, र मुख्य स्थानहोल्डरलाई तपाईंको ड्यासबोर्डको कुञ्जीद्वारा बदल्नुहोस्।

curl -X GET https://api.zinndigital.com/v1/ai/recipes/{recipeId} \
  -H "Authorization: Bearer zdk_live_…"

लगइन गर्नुभएको छ? तपाईंको ड्यासबोर्डमा रहेको API कन्सोलले तपाईंको वास्तविक संस्थाको आईडी र आफ्नै कुञ्जी भरिदिन्छ, र लाइभ API विरुद्ध अनुरोध चलाउँछ ताकि तपाईंले वास्तविक प्रतिक्रिया हेर्न सक्नुहोस्। यो एन्डपोइन्टलाई API कन्सोलमा खोल्नुहोस्

विवरणहरू

Requires `links.view`.

प्यारामिटरहरू

नामप्रकारआवश्यकयो के हो
recipeId (path)Uuidहुन्छ

प्रतिक्रिया

नामप्रकारआवश्यकयो के हो
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 · 429