Synupv1
Criar chave
v1Recursos/Post Ideas/patchAtualizar uma ideia de publicação

Atualizar uma ideia de publicação

Atualiza os campos editáveis de uma ideia de publicação. id aceita seu próprio id ou o externalId com o qual foi criada.

patch/api/v1/post-ideas/{id}
ideas:write
Parâmetros de consulta
idstringobrigatório
A ideia de publicação a ser atualizada — seu id ou externalId.
Corpo da solicitação
titlestringopcional
O título da ideia. Obrigatório na criação.
contentstringopcional
A legenda/conteúdo do corpo da ideia.
imageUrlstringopcional
URL de uma imagem para anexar à ideia.
imagePromptstringopcional
O prompt usado para gerar a imagem da ideia.
typestring (announcement | offer | tip | showcase | story | event)opcional
Tipo de ideia.
statusstring (draft | published | archived)opcional
Status da ideia.
platformsarray of stringopcional
Plataformas para as quais esta ideia se destina.
scheduledDatestringopcional
Data planejada de publicação (YYYY-MM-DD).
scheduledTimestringopcional
Horário planejado de publicação.
Resposta
dataobjectopcional
idstringopcional
Identificador único da ideia de publicação.
locationIdstringopcional
ID do local ao qual esta ideia pertence, ou null para uma ideia em nível de marca.
clientLocationIdstringopcional
ID do registro de local resolvido, ou null.
clientIdstringopcional
ID do cliente ao qual esta ideia pertence (ideias em nível de marca), ou null.
brandNamestringopcional
Nome de exibição do perfil da marca, para ideias em nível de marca, ou null.
titlestringopcional
O título da ideia.
contentstringopcional
A legenda/conteúdo do corpo da ideia.
imageUrlstringopcional
URL da imagem da ideia, ou null.
imagePromptstringopcional
O prompt usado para gerar a imagem da ideia, ou null.
typestring (announcement | offer | tip | showcase | story | event)opcional
Tipo de ideia: announcement, offer, tip, showcase, story ou event.
statusstring (draft | published | archived)opcional
Status da ideia: draft, published ou archived.
bucketstring (idea | holiday | calendar | series)opcional
Em qual bucket da grade a ideia se encontra: idea, holiday, calendar ou series.
platformsarray of stringopcional
Plataformas para as quais esta ideia se destina.
seriesIdstringopcional
ID da série de conteúdo à qual esta ideia pertence, ou null.
scheduledDatestringopcional
Data planejada de publicação (YYYY-MM-DD), ou null.
scheduledTimestringopcional
Horário planejado de publicação, ou null.
externalIdstringopcional
id estável com o qual esta ideia foi criada, se veio de uma fonte externa.
sourcestring (os | agent)opcional
De onde a ideia veio: os (criada no Synup) ou agent (enviada por um agente de IA).
reviewStatusstring (pending | approved | rejected)opcional
Portão de aprovação: null (sem portão), pending, approved ou rejected.
generationJobIdstringopcional
ID do job de geração por IA que produziu esta ideia, se houver, ou null.
isUserGeneratedbooleanopcional
Se uma pessoa (em vez de um agente) criou esta ideia.
archivedbooleanopcional
Se esta ideia foi arquivada.
archivedAtstringopcional
Quando esta ideia foi arquivada, como timestamp ISO 8601, ou null.
createdAtstringopcional
Quando esta ideia foi criada, como timestamp ISO 8601.
updatedAtstringopcional
Quando esta ideia foi atualizada por último, como timestamp ISO 8601.
locationNamestringopcional
Nome de exibição do local da ideia. Presente apenas ao listar as ideias em nível de local de um cliente.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
patch/api/v1/post-ideas/{id}
Sua chave de API
id *
Corpo da solicitação
{
  "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"
  }
}