syndication

PUT `/v1/syndication/plans/{planId}`

Change a plan's channels or behaviour.

Autenticación

Envía una clave de API como token de portador. Este endpoint no especifica un permiso concreto en la especificación, así que otorga a tu clave los mínimos privilegios necesarios y comprueba la respuesta en lugar de dar por sentado.

Este endpoint no requiere ningún id de organización. Su clave ya identifica la organización a la que pertenece, y la respuesta está delimitada a ella.

Pruébalo

Reemplaza cualquier elemento entre corchetes angulares por tus propios valores, y el marcador de posición key con una clave de tu panel de control.

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>> }'

¿Has iniciado sesión? La consola de la API en tu panel de control rellena el ID de tu organización real y tu propia clave, y ejecuta la solicitud contra la API en vivo para que puedas ver la respuesta real. Abre este endpoint en la consola de la API

Detalles

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`.

Parámetros

Nombre	Tipo	Obligatorio	¿Qué es esto?
`planId (path)`	`string`	Sí	—

Cuerpo de la solicitud

Nombre	Tipo	Obligatorio	¿Qué es esto?
`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	—

Respuesta

Nombre	Tipo	Obligatorio	¿Qué es esto?
`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í	—

Errores que este endpoint puede devolver

401 · 403 · 404

PUT /v1/syndication/plans/{planId}