Anexar mídia de um upload

curl --request POST \
  --url https://post.chatclean.com.br/api/posts/{post}/media/from-upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "upload_token": "4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b",
  "alt": "Banner de lançamento do produto"
}
'

import requests

url = "https://post.chatclean.com.br/api/posts/{post}/media/from-upload"

payload = {
    "upload_token": "4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b",
    "alt": "Banner de lançamento do produto"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    upload_token: '4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b',
    alt: 'Banner de lançamento do produto'
  })
};

fetch('https://post.chatclean.com.br/api/posts/{post}/media/from-upload', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://post.chatclean.com.br/api/posts/{post}/media/from-upload",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'upload_token' => '4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b',
    'alt' => 'Banner de lançamento do produto'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://post.chatclean.com.br/api/posts/{post}/media/from-upload"

	payload := strings.NewReader("{\n  \"upload_token\": \"4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b\",\n  \"alt\": \"Banner de lançamento do produto\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://post.chatclean.com.br/api/posts/{post}/media/from-upload")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"upload_token\": \"4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b\",\n  \"alt\": \"Banner de lançamento do produto\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://post.chatclean.com.br/api/posts/{post}/media/from-upload")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"upload_token\": \"4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b\",\n  \"alt\": \"Banner de lançamento do produto\"\n}"

response = http.request(request)
puts response.read_body

{
  "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": "Lançamos as sequências agendadas. Veja como funcionam.",
  "media": [
    {
      "id": "9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
      "path": "medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
      "url": "https://example.com/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 de lançamento do produto"
      }
    }
  ],
  "status": "scheduled",
  "schedule_mode": "custom",
  "scheduled_at": "2026-11-12 14: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": []
          }
        ]
      },
      "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-10-01 10:00:00",
      "updated_at": "2026-10-01 10:00:00"
    }
  ],
  "created_at": "2026-11-06 13:20:11",
  "updated_at": "2026-11-06 13:20:11"
}

{
  "message": "Unauthenticated."
}

{
  "message": "Active subscription required."
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>",
  "errors": {}
}

{
  "name": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Please retry after 30 seconds."
}

Mídia e uploads

Anexar mídia de um upload

Adiciona ao fim das mídias do post um arquivo enviado antes (POST /uploads ou uma URL assinada). O post guarda uma cópia própria do arquivo e o token é consumido. Um token desconhecido ou expirado (uploads valem 24 horas) falha com 422 em upload_token: Este envio expirou. Adicione o arquivo novamente. Só são aceitos os tipos de mídia que todos os canais ativos do post aceitam. Um tipo que o canal não aceita falha com 422 em upload_token: This file type is not supported by the post's channel. Posts publicando, publicados ou com falha não aceitam mídia: 422 em post com Este post já foi processado e não pode ser republicado. Duplique-o para tentar de novo. No Pinterest e no TikTok o content_type de cada destino é escolhido de novo a partir das mídias do post, como na criação. As mensagens de validação seguem o idioma do servidor, português no PostClean.

POST

posts

{post}

media

from-upload

Anexar mídia de um upload

curl --request POST \
  --url https://post.chatclean.com.br/api/posts/{post}/media/from-upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "upload_token": "4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b",
  "alt": "Banner de lançamento do produto"
}
'

import requests

url = "https://post.chatclean.com.br/api/posts/{post}/media/from-upload"

payload = {
    "upload_token": "4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b",
    "alt": "Banner de lançamento do produto"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    upload_token: '4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b',
    alt: 'Banner de lançamento do produto'
  })
};

fetch('https://post.chatclean.com.br/api/posts/{post}/media/from-upload', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://post.chatclean.com.br/api/posts/{post}/media/from-upload",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'upload_token' => '4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b',
    'alt' => 'Banner de lançamento do produto'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://post.chatclean.com.br/api/posts/{post}/media/from-upload"

	payload := strings.NewReader("{\n  \"upload_token\": \"4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b\",\n  \"alt\": \"Banner de lançamento do produto\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://post.chatclean.com.br/api/posts/{post}/media/from-upload")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"upload_token\": \"4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b\",\n  \"alt\": \"Banner de lançamento do produto\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://post.chatclean.com.br/api/posts/{post}/media/from-upload")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"upload_token\": \"4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b\",\n  \"alt\": \"Banner de lançamento do produto\"\n}"

response = http.request(request)
puts response.read_body

{
  "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": "Lançamos as sequências agendadas. Veja como funcionam.",
  "media": [
    {
      "id": "9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
      "path": "medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
      "url": "https://example.com/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 de lançamento do produto"
      }
    }
  ],
  "status": "scheduled",
  "schedule_mode": "custom",
  "scheduled_at": "2026-11-12 14: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": []
          }
        ]
      },
      "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-10-01 10:00:00",
      "updated_at": "2026-10-01 10:00:00"
    }
  ],
  "created_at": "2026-11-06 13:20:11",
  "updated_at": "2026-11-06 13:20:11"
}

{
  "message": "Unauthenticated."
}

{
  "message": "Active subscription required."
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>",
  "errors": {}
}

{
  "name": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Please retry after 30 seconds."
}

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

upload_token

string<uuid>

required

Token devolvido por POST /uploads ou pela URL assinada.

alt

string | null

Texto alternativo. Vale só para imagens e é ignorado em vídeos e PDFs.

Maximum string length: 2000

Response

O post com a nova mídia.

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.

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.

Visão geral

Posts

Notas de posts

Aprovações

Recorrência

Mídia e uploads

Contas sociais

Canais

Ideias

Etapas de ideias

Análises

Etiquetas

Assinaturas

Workspace

Chaves de API

Webhooks

Repost

Plataforma

Anexar mídia de um upload

Authorizations

Path Parameters

Body

Response