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

Criar uma ideia de publicação

Cria (ou, para um externalId repetido, atualiza) uma ideia de publicação em rascunho, aguardando revisão ou pronta para publicar.

post/api/v1/post-ideas
ideas:write
Corpo da solicitação
locationIdstringopcional
O local para o qual esta ideia se destina, ou omita para uma ideia em nível de marca.
clientIdstringopcional
O cliente para o qual esta ideia se destina (ideias em nível de marca).
titlestringobrigatório
O título da ideia. Obrigatório na criação.
contentstringopcional
A legenda/conteúdo do corpo da ideia.
externalIdstringobrigatório
Um id estável que você controla — repetir uma criação com o mesmo externalId atualiza a ideia existente em vez de duplicá-la. Obrigatório na criação.
originstring (channel | routine | os_button)obrigatório
De onde esta ideia está vindo: channel, routine ou os_button. Obrigatório na criação.
typestring (announcement | offer | tip | showcase | story | event)opcional
Tipo de ideia.
bucketstring (idea | holiday | calendar | series)opcional
Em qual bucket da grade a ideia se encontra.
platformsarray of stringopcional
Plataformas para as quais esta ideia se destina.
imageUrlstringopcional
URL de uma imagem para anexar à ideia.
imagePromptstringopcional
O prompt usado para gerar a imagem da ideia.
seriesIdstringopcional
ID da série de conteúdo à qual anexar esta ideia.
scheduledDatestringopcional
Data planejada de publicação (YYYY-MM-DD).
scheduledTimestringopcional
Horário planejado de publicação.
generationJobIdstringopcional
ID do job de geração por IA que produziu esta ideia, se houver.
Resposta
dataobjectopcional
idstringopcional
Identificador único da ideia de publicação.
createdbooleanopcional
Se esta chamada criou uma nova ideia (false se uma ideia com este externalId já existia e foi atualizada em vez disso).
reviewStatusstringopcional
Portão de aprovação: null (sem portão), pending, approved ou rejected.
statusstringopcional
Status da ideia: draft, published ou archived.
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.
422Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
post/api/v1/post-ideas
Sua chave de API
Corpo da solicitação*
{
  "data": {
    "id": "cm_idea_abc123",
    "created": true,
    "reviewStatus": null,
    "status": "draft"
  }
}