Synupv1
Crear clave
v1Recursos/Post Ideas/postPublicar una idea de publicación

Publicar una idea de publicación

Publica una idea de publicación como una publicación real, enviándola a sus plataformas de destino. Salvo que se indique scheduledFor o draft, esto envía contenido real de inmediato. id acepta tanto el propio id de la idea como el externalId con el que se creó.

post/api/v1/post-ideas/{id}/publish
posts:write
Parámetros de consulta
idstringobligatorio
La idea de publicación a publicar — su id o externalId.
Cuerpo de la solicitud
scheduledForstringopcional
Publicar en esta marca de tiempo ISO 8601 futura en lugar de inmediatamente.
draftbooleanopcional
Guardar como publicación en borrador en lugar de publicar de inmediato.
Respuesta
dataobjectopcional
Una plataforma solicitada sin conexión activa, o un campo que la idea necesita antes de poder publicarse, nunca hace fallar esta llamada — la idea se guarda como publicación en borrador en su lugar. Volver a llamar a esto para una idea que ya tiene una publicación devuelve alreadyPublished: true en lugar de crear una segunda.
postIdstringopcional
ID de la publicación en la que se publicó esta idea, o null si la publicación no se completó.
statusstringopcional
Estado de la idea: draft, published o archived.
ideaIdstringopcional
ID de la idea de publicación que se publicó.
alreadyPublishedbooleanopcional
Si esta idea ya tenía una publicación de una llamada anterior — cuando es true, no se publicó nada nuevo.
missingFieldsarray of stringopcional
Campos aún necesarios antes de que la publicación resultante pueda activarse, si los hay.
missingPlatformsarray of stringopcional
Plataformas solicitadas sin conexión activa, si las hay.
scopestring (location | client)opcional
Si la brecha de conexión/campo aplica a nivel de ubicación o de cliente.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
422A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
post/api/v1/post-ideas/{id}/publish
Su clave de API
id *
Cuerpo de la solicitud
{
  "data": {
    "postId": "cm_post_xyz789",
    "status": "scheduled",
    "ideaId": "cm_idea_abc123"
  }
}