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

Actualizar una idea de publicación

Actualiza los campos editables de una idea de publicación. id acepta tanto su propio id como el externalId con el que se creó.

patch/api/v1/post-ideas/{id}
ideas:write
Parámetros de consulta
idstringobligatorio
La idea de publicación a actualizar — su id o externalId.
Cuerpo de la solicitud
titlestringopcional
El título de la idea. Obligatorio al crear.
contentstringopcional
El texto/contenido de la idea.
imageUrlstringopcional
URL de una imagen para adjuntar a la idea.
imagePromptstringopcional
El prompt usado para generar la imagen de la idea.
typestring (announcement | offer | tip | showcase | story | event)opcional
Tipo de idea.
statusstring (draft | published | archived)opcional
Estado de la idea.
platformsarray of stringopcional
Plataformas para las que está pensada esta idea.
scheduledDatestringopcional
Fecha de publicación planificada (YYYY-MM-DD).
scheduledTimestringopcional
Hora de publicación planificada.
Respuesta
dataobjectopcional
idstringopcional
Identificador único de la idea de publicación.
locationIdstringopcional
ID de la ubicación a la que pertenece esta idea, o null para una idea a nivel de marca.
clientLocationIdstringopcional
ID del registro de ubicación resuelto, o null.
clientIdstringopcional
ID del cliente al que pertenece esta idea (ideas a nivel de marca), o null.
brandNamestringopcional
Nombre visible del perfil de marca, para ideas a nivel de marca, o null.
titlestringopcional
El título de la idea.
contentstringopcional
El texto/contenido de la idea.
imageUrlstringopcional
URL de la imagen de la idea, o null.
imagePromptstringopcional
El prompt usado para generar la imagen de la idea, o null.
typestring (announcement | offer | tip | showcase | story | event)opcional
Tipo de idea: announcement, offer, tip, showcase, story o event.
statusstring (draft | published | archived)opcional
Estado de la idea: draft, published o archived.
bucketstring (idea | holiday | calendar | series)opcional
En qué bucket de la cuadrícula se ubica la idea: idea, holiday, calendar o series.
platformsarray of stringopcional
Plataformas para las que está pensada esta idea.
seriesIdstringopcional
ID de la serie de contenido a la que pertenece esta idea, o null.
scheduledDatestringopcional
Fecha de publicación planificada (YYYY-MM-DD), o null.
scheduledTimestringopcional
Hora de publicación planificada, o null.
externalIdstringopcional
ID estable con el que se creó esta idea, si provino de una fuente externa.
sourcestring (os | agent)opcional
De dónde vino la idea: os (creada en Synup) o agent (enviada por un agente de IA).
reviewStatusstring (pending | approved | rejected)opcional
Puerta de aprobación: null (sin puerta), pending, approved o rejected.
generationJobIdstringopcional
ID del trabajo de generación de IA que produjo esta idea, si lo hay, o null.
isUserGeneratedbooleanopcional
Si una persona (en lugar de un agente) creó esta idea.
archivedbooleanopcional
Si esta idea ha sido archivada.
archivedAtstringopcional
Cuándo se archivó esta idea, como marca de tiempo ISO 8601, o null.
createdAtstringopcional
Cuándo se creó esta idea, como marca de tiempo ISO 8601.
updatedAtstringopcional
Cuándo se actualizó por última vez esta idea, como marca de tiempo ISO 8601.
locationNamestringopcional
Nombre visible de la ubicación de la idea. Solo presente al listar las ideas a nivel de ubicación de un 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.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
patch/api/v1/post-ideas/{id}
Su clave de API
id *
Cuerpo de la solicitud
{
  "data": {
    "id": "cm_idea_abc123",
    "agencyId": "cm_agency_1",
    "locationId": "cm_loc_1",
    "clientLocationId": "cm_loc_1",
    "clientId": null,
    "brandName": null,
    "agentMeta": null,
    "title": "Spotlight our new patient special (updated)",
    "content": "Book this month and get 25% off your first cleaning!",
    "imagePrompt": null,
    "imageUrl": null,
    "type": "announcement",
    "status": "draft",
    "bucket": "idea",
    "platforms": [
      "google",
      "facebook"
    ],
    "seriesId": null,
    "scheduledDate": null,
    "scheduledTime": null,
    "observanceName": null,
    "observanceDate": null,
    "generationBatchId": null,
    "generationJobId": null,
    "isUserGenerated": true,
    "source": "os",
    "externalId": "cm_idea_abc123",
    "reviewStatus": null,
    "archived": false,
    "archivedAt": null,
    "createdAt": "2026-01-20T09:00:00.000Z",
    "updatedAt": "2026-01-20T09:05:00.000Z"
  }
}