Enviar mídia

curl --request POST \
  --url https://post.chatclean.com.br/api/posts/{post}/media \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form media=@example-file

import requests

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

files = { "media": ("example-file", open("example-file", "rb")) }
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('media', '<string>');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://post.chatclean.com.br/api/posts/{post}/media', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"media\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: multipart/form-data"
  ],
]);

$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"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"media\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")

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

	req.Header.Add("Authorization", "Bearer <token>")

	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")
  .header("Authorization", "Bearer <token>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"media\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"media\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--"

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

Enviar mídia

Envia um arquivo como multipart/form-data no campo media e o adiciona ao fim das mídias do post. Arquivos aceitos: imagens JPEG, PNG, GIF e WebP (também HEIC e HEIF quando o servidor consegue convertê-los, e nesse caso são salvos como JPEG), vídeos MP4 e MOV e documentos PDF. Limites de tamanho: 10 MB por imagem (e no máximo 8192 x 8192 pixels, cerca de 67 megapixels), 1 GB por vídeo e 100 MB por PDF. Cada rede aplica seus próprios limites, em geral menores, quando o post é agendado ou publicado (veja GET /content-types). 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 media: 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. Quem precisa de aprovação e altera um post agendado e já aprovado manda o post de volta para aprovação. As mensagens de validação seguem o idioma do servidor, português no PostClean.

POST

posts

{post}

media

Enviar mídia

curl --request POST \
  --url https://post.chatclean.com.br/api/posts/{post}/media \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form media=@example-file

import requests

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

files = { "media": ("example-file", open("example-file", "rb")) }
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('media', '<string>');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://post.chatclean.com.br/api/posts/{post}/media', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"media\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: multipart/form-data"
  ],
]);

$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"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"media\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")

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

	req.Header.Add("Authorization", "Bearer <token>")

	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")
  .header("Authorization", "Bearer <token>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"media\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"media\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--"

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

multipart/form-data

media

file

required

O arquivo, no campo media.

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

Enviar mídia

Authorizations

Path Parameters

Body

Response