Atualizar post

Atualiza um post. Só os campos enviados mudam. A conta social do post não muda (social_account_id é recusado).

Num post com um destino (todos os criados pela API), mande content_type e meta no nível de cima ou dentro de platforms, com um único item cujo id é o do destino (platforms[0].id do post). Não misture as duas formas: platforms com outro id, com mais de um item ou junto com content_type/meta no nível de cima responde 422 em platforms. Nos dois casos os erros aparecem em platforms.0.* (por exemplo platforms.0.meta.privacy_level, platforms.0.content_type); as checagens feitas ao montar o post aparecem em destinations.0.*.

meta é mesclado com o que está salvo, chave por chave: mande null numa chave para apagá-la; thread_replies substitui a lista inteira. media substitui as mídias do post; label_ids substitui as etiquetas.

status: publishing publica agora; scheduled agenda em scheduled_at, na fila (queue) ou mantém o horário futuro que o post já tem; draft tira o post da agenda (o último scheduled_at continua no rascunho). Um post da fila editado sem queue nem scheduled_at continua no seu horário da fila. Ao agendar ou publicar, o formato precisa servir para a mídia e as configurações obrigatórias da rede precisam estar presentes.

Posts antigos com vários destinos aceitam platforms com os id dos destinos ativos que devem continuar; os que não forem listados são desativados. Nesses posts, queue é recusado.

Posts que estão publicando, publicados, parcialmente publicados ou com falha não podem ser editados: a resposta é 422 com {"message": "Este post já foi processado e não pode ser republicado. Duplique-o para tentar de novo."} (as mensagens de validação seguem o idioma do servidor, português no PostClean).

A chave de API age como o usuário que a criou. Só admins do workspace criam chaves, e admins publicam direto, então o post não fica pending_approval.

Neste endpoint um corpo inválido pode responder 422 antes da checagem de 404 de um post de outro workspace.

PUT /posts/{post}

cURL

flat

curl --request PUT \ --url https://post.chatclean.com.br/api/posts/{post} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "content": "Agora dá para agendar fios no X (e corrigimos alguns detalhes).", "status": "scheduled", "queue": "next", "meta": { "thread_replies": [ { "text": "2/ As respostas saem logo abaixo do primeiro post." }, { "text": "3/ A lista completa de mudanças está no blog." } ] } } '

200

{
  "id": "9d3c1f2a-6b4e-4c8a-9f1e-2a7b5c8d0e41",
  "post_group_id": "9d3c1f29-e0a1-4b7c-8d2e-5f6a7b8c9d03",
  "author": {
    "id": "9b1e2d3c-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
    "name": "Ana Souza"
  },
  "content": "Agora dá para agendar fios no X (e corrigimos alguns detalhes).",
  "media": [
    {
      "id": "9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
      "path": "medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
      "url": "https://post.chatclean.com.br/storage/medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
      "type": "image",
      "mime_type": "image/jpeg",
      "original_filename": "lancamento.jpg",
      "size": 482113,
      "meta": {
        "width": 1080,
        "height": 1350,
        "alt_text": "Banner do lançamento"
      }
    }
  ],
  "status": "scheduled",
  "schedule_mode": "queue",
  "scheduled_at": "2026-11-07 12:00:00",
  "published_at": null,
  "approval_requested_by": null,
  "approval_requested_at": null,
  "approved_by": null,
  "approved_at": null,
  "recurrence": null,
  "origin": "trypost",
  "platforms": [
    {
      "id": "9d3c1f2b-1a2b-4c3d-8e4f-5a6b7c8d9e0f",
      "platform": "x",
      "content_type": "x_post",
      "meta": {
        "thread_replies": [
          {
            "text": "2/ As respostas saem logo abaixo do primeiro post.",
            "media": []
          },
          {
            "text": "3/ A lista completa de mudanças está no blog.",
            "media": []
          }
        ]
      },
      "status": "pending",
      "enabled": true,
      "platform_url": null,
      "published_at": null,
      "error_message": null,
      "display_name": "PostClean",
      "display_username": "postclean",
      "display_avatar": "https://pbs.twimg.com/profile_images/1790000000000000000/avatar_400x400.jpg",
      "social_account": {
        "id": "9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54",
        "platform": "x",
        "display_name": "PostClean",
        "username": "postclean",
        "status": "connected",
        "has_posting_schedule": true,
        "timezone": "America/Sao_Paulo",
        "posting_goal": 5,
        "max_content_length": 280,
        "long_posts": false,
        "verified_badge": null
      }
    }
  ],
  "labels": [
    {
      "id": "9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f",
      "name": "Lançamento",
      "color": "#2563EB",
      "created_at": "2026-09-01 10:00:00",
      "updated_at": "2026-09-01 10:00:00"
    }
  ],
  "created_at": "2026-11-06 13:20:11",
  "updated_at": "2026-11-06 15:42:08"
}

Authorizations

Authorization · string · header · required

Chave de API do workspace, criada em Configurações > Chaves de API.

Path Parameters

post · string<uuid> · required

Id do post. Um post de outro workspace devolve 404.

Body

application/json

content · string | null

Texto do post, até 25000 caracteres. Com status scheduled ou publishing, também precisa caber no limite da conta (max_content_length da conta social: 280 no X, 25000 em contas do X com posts longos, 300 no Bluesky, 500 no Mastodon contando o aviso de conteúdo), medido no texto que a rede recebe. Um post agendado ou publicado precisa de texto ou mídia.

Maximum string length: 25000

media · object[]

Substitui as mídias do post. Sem este campo, as mídias atuais ficam. Mídias em ordem. Cada item traz exatamente um entre upload_token, url ou id. Tipos que a rede do canal não aceita são recusados.

Show child attributes

status · enum<string>

draft salva um rascunho editável. scheduled agenda em scheduled_at ou na fila do canal (queue). publishing publica agora. Sem este campo, o status atual fica.

Available options: draft, scheduled, publishing

content_type · enum<string>

Novo formato do canal do post. Sem ele, o formato salvo continua, exceto no Pinterest e no TikTok, onde mídias novas escolhem o formato como na criação.

Available options: instagram_feed, instagram_reel, instagram_story, linkedin_post, linkedin_page_post, facebook_post, facebook_reel, facebook_story, tiktok_video, tiktok_photo, youtube_short, x_post, threads_post, threads_ghost_post, pinterest_pin, pinterest_video_pin, pinterest_carousel, bluesky_post, mastodon_post, telegram_post, discord_message, google_business_post

meta · X · object

Configurações do canal do post, mescladas com as salvas.

X

Bluesky

Mastodon

TikTok

Pinterest

Discord

YouTube

Instagram

Threads

Facebook

LinkedIn

Google Business Profile

Telegram

Show child attributes

platforms · object[]

Outra forma de mandar content_type e meta, por destino. Num post com um destino, exatamente um item com o id desse destino.

Show child attributes

scheduled_at · string<date-time> | null

Com status: scheduled: obrigatório, a não ser que vá queue ou o post já tenha um horário futuro; precisa estar no futuro e antes de 2038-01-19. Não combina com queue.

queue · enum<string> | null

Posição na fila, só com status: scheduled. next pega o primeiro horário livre do canal; top pega o primeiro horário e empurra os posts da fila que estão atrás dele para a próxima lacuna. O canal precisa ter horários de postagem (has_posting_schedule). Não combina com scheduled_at. Recusado em posts antigos com vários destinos.

Available options: next, top, null

label_ids · string<uuid>[]

Substitui as etiquetas do post.

Response

200

application/json

O post atualizado.

Um post em um canal. Posts criados juntos para vários canais são posts independentes que compartilham o mesmo post_group_id. O canal, o formato, as configurações da rede e o resultado da publicação ficam em platforms.

id · string<uuid>

post_group_id · string<uuid> | null

Igual em todos os posts criados na mesma requisição.

author · object | null

Um membro do workspace. Só o id e o nome são expostos.

Show child attributes

content · string | null

Texto do post, guardado como foi enviado (posts escritos no app guardam o HTML do editor).

media · object[] | null

Show child attributes

status · enum<string>

Ciclo de vida do post no PostClean. pending_approval é um post que um membro que precisa de aprovação pediu para agendar ou publicar. partially_published aparece em posts antigos com vários destinos quando só parte deles foi publicada. O resultado em cada rede fica em platforms[].status.

Available options: draft, pending_approval, scheduled, publishing, published, partially_published, failed

schedule_mode · enum<string> | null

queue: o post ocupa um horário da grade de postagem do canal. custom: está agendado num horário próprio.

Available options: queue, custom, null

scheduled_at · string | null

UTC, no formato Y-m-d H:i:s.

published_at · string | null

UTC, no formato Y-m-d H:i:s.

approval_requested_by · object | null

Quem pediu a aprovação (nem sempre é o autor).

Show child attributes

approval_requested_at · string | null

UTC, no formato Y-m-d H:i:s.

approved_by · object | null

Um membro do workspace. Só o id e o nome são expostos.

Show child attributes

approved_at · string | null

UTC, no formato Y-m-d H:i:s.

recurrence · object | null

Regra de repetição, ou null.

Show child attributes

origin · enum<string>

trypost para posts criados no PostClean. network para posts importados da rede (publicados fora do PostClean).

Available options: trypost, network

platforms · object[]

Destinos do post. Posts criados pela API têm exatamente um.

Show child attributes

labels · object[]

Show child attributes

created_at · string

UTC, no formato Y-m-d H:i:s.

updated_at · string

UTC, no formato Y-m-d H:i:s.