Pular para o conteúdo
Social

Guardar ideia de post

v1.0.0
POSThttps://api.growthaisystem.com/api/v1/social/posts
  • ExigeAuthorization: Bearer gos_…— Chave de API (gos_…)· escopossocial.write

Guarda uma ideia de post na gaveta de Ideias do planejador — texto e, se quiser, o contexto (brief) e uma imagem pronta (image, que entra na biblioteca de mídia do planejador). NUNCA agenda nem publica: sem data e sem rede, a ideia espera uma pessoa do time abrir, ajustar, escolher as redes e agendar na tela. É a aprovação natural de tudo que um agente escreve para as redes.

Sem Idempotency-Key: repetir a chamada guarda outra ideia (inofensivo — nada sai da gaveta sozinho).

Corpo da requisição

application/jsonobrigatório

V1SocialIdeaInputInput

  • contentstringobrigatório

    O texto da ideia (legenda, roteiro, tópicos).

    • tamanho 1–20000
  • briefstring | nullopcional

    Contexto da peça para quem for produzir/agendar: objetivo, público, referência.

    • tamanho máx. 5000

  • Uma imagem pronta para a ideia (a arte que um agente criou). Fica na biblioteca de mídia do planejador; nada é publicado.

    • base64stringobrigatório

      Os bytes da imagem em base64 (sem o prefixo data:).

      • tamanho 1–8000000
    • mimeTypestringobrigatório
      • um de"image/png""image/jpeg""image/webp"
    • altstring | nullopcional

      Descrição da imagem (acessibilidade).

      • tamanho máx. 500

Respostas

6 respostas documentadas — o código, o que ele significa nesta rota e a forma do corpo.

201Deu certoapplication/json

A ideia guardada na gaveta de Ideias (status: idea, sem data e sem rede).

V1SocialPost

  • idstring
  • statusstring
  • contentstring

  • Cada item — V1SocialMedia

    • assetIdstring
    • kindstring
    • altstring | null
    • thumbUrlstring | null
  • scheduledForstring | null
  • timezonestring | null
  • briefstring | null

  • Cada item — V1SocialPostTarget

    • idstring
    • connectionIdstring
    • platformV1SocialPlatform

      Rede da conta: instagram, facebook, linkedin, tiktok, youtube, googlebusiness…

    • formatstring
    • accountNamestring | null
    • accountHandlestring | null
    • contentstring | null
    • scheduledForstring | null
    • statusstring
    • errorCategorystring | null
    • permalinkstring | null
    • publishedAtstring | null
  • createdAtstring
  • updatedAtstring