syndication
PUT /v1/syndication/plans/{planId}
Change a plan's channels or behaviour.
Pagpapatotoo
Magpadala ng API key bilang bearer token. Ang endpoint na ito ay hindi naglatag ng tiyak na pahintulot sa pagtutukoy, kaya ibigay sa iyong key ang pinakamababang kailangan nito at suriin ang tugon sa halip na umasa.
Ang endpoint na ito ay hindi nangangailangan ng id ng organisasyon. Natutukoy na ng iyong key ang organisasyong kinabibilangan nito, at nakatuon ang tugon dito.
Subukan ito
Palitan ang anuman sa loob ng mga panaklong na may anggulo ng iyong sariling mga halaga, at ang placeholder ng key na may key mula sa iyong dashboard.
curl -X PUT https://api.zinndigital.com/v1/syndication/plans/{planId} \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "scope": <string<post, recipe, org_default>> }'Nakalagda? Ang API console sa iyong dashboard ay awtomatikong naglalagay ng iyong tunay na ID ng organisasyon at sariling susi, at pinapatakbo ang kahilingan laban sa live na API upang makita mo ang aktwal na tugon. Buksan ang endpoint na ito sa console ng API
Mga Detalye
Replaces the plan's channel set with `connection_ids`. ⛔ Each id is re-checked against the CALLER's scope, not merely the plan's org — a connection id is a UUID somebody could paste, and a plan naming another tenant's connection would post this article to that tenant's account. Gated on `syndication.manage`.
Mga Parameter
| Pangalan | Uri | Kailangan | Ano ito |
|---|---|---|---|
planId (path) | string | Oo | — |
Katawan ng kahilingan
| Pangalan | Uri | Kailangan | Ano ito |
|---|---|---|---|
scope | string<post, recipe, org_default> | Oo | — |
post_id | string | Hindi | — |
recipe_id | string | Hindi | — |
enabled | boolean | Hindi | — |
write_mode | string<ai_per_channel, one_text> | Hindi | — |
approval_mode | string<hold, send> | Hindi | — |
connection_ids | string[] | Hindi | — |
Tugon
| Pangalan | Uri | Kailangan | Ano ito |
|---|---|---|---|
id | string | Oo | — |
scope | string<post, recipe, org_default> | Oo | Most specific wins — an article's own plan beats its recipe's beats the org default. |
post_id | string | Oo | — |
recipe_id | string | Oo | — |
enabled | boolean | Oo | — |
write_mode | string<ai_per_channel, one_text> | Oo | ⚖️ Owner ruling 2026-08-20 — the AI writes per channel by default, because an X post and a LinkedIn update are not the same piece of writing. |
approval_mode | string<hold, send> | Oo | ⚖️ Owner ruling 2026-08-20 — hold for approval by default. |
channels | SyndicationPlanChannel[] | Oo | — |
created_at | string | Oo | — |
Mga error na maibabalik ng endpoint na ito
401 · 403 · 404