Autenticazione
Invia una chiave API come bearer token. Questo endpoint non specifica un permesso specifico nella specifica, quindi assegna alla tua chiave i permessi minimi necessari e verifica la risposta invece di fare supposizioni.
L'ID della tua organizzazione va qui
Questo endpoint accetta org_id come parametro di query. Omettilo e la chiamata coprirà l'intero sottoalbero del tuo tenant; invialo per limitare la chiamata a una singola organizzazione.
L'identificativo della tua organizzazione si trova nella schermata delle chiavi API nella tua dashboard, accanto alla chiave stessa. È lo stesso identificativo in ogni chiamata che effettui.
Provalo
Sostituisci qualsiasi elemento tra parentesi angolari con i tuoi valori e il segnaposto key con una chiave dalla tua dashboard.
curl -X POST https://api.zinndigital.com/v1/syndication/plans \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "scope": <string<post, recipe, org_default>> }'Hai effettuato l'accesso? La console API nella tua dashboard inserisce il tuo ID organizzazione reale e la tua chiave personale, ed esegue la richiesta sull'API live in modo da poter vedere la risposta effettiva. Apri questo endpoint nella console API
Dettagli
A plan for one article (`post`), for a recipe (`recipe`) or for everything (`org_default`); the most specific one wins and a disabled plan stops the search rather than falling through. `approval_mode` defaults to `hold` — owner ruling, 2026-08-20. Gated on `syndication.manage`.
Parametri
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
org_id (query) | string | No | — |
Corpo della richiesta
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
scope | string<post, recipe, org_default> | Sì | — |
post_id | string | No | — |
recipe_id | string | No | — |
enabled | boolean | No | — |
write_mode | string<ai_per_channel, one_text> | No | — |
approval_mode | string<hold, send> | No | — |
connection_ids | string[] | No | — |
Risposta
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
id | string | Sì | — |
scope | string<post, recipe, org_default> | Sì | Most specific wins — an article's own plan beats its recipe's beats the org default. |
post_id | string | Sì | — |
recipe_id | string | Sì | — |
enabled | boolean | Sì | — |
write_mode | string<ai_per_channel, one_text> | Sì | ⚖️ 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> | Sì | ⚖️ Owner ruling 2026-08-20 — hold for approval by default. |
channels | SyndicationPlanChannel[] | Sì | — |
created_at | string | Sì | — |
Errori che questo endpoint può restituire
401 · 403 · 422