Definir repetição do post

curl --request PATCH \
  --url https://post.chatclean.com.br/api/posts/{post}/recurrence \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "interval": 1,
  "frequency": "week",
  "times": 4
}
'

import requests

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

payload = {
    "interval": 1,
    "frequency": "week",
    "times": 4
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({interval: 1, frequency: 'week', times: 4})
};

fetch('https://post.chatclean.com.br/api/posts/{post}/recurrence', 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}/recurrence",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'interval' => 1,
    'frequency' => 'week',
    'times' => 4
  ]),
  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}/recurrence"

	payload := strings.NewReader("{\n  \"interval\": 1,\n  \"frequency\": \"week\",\n  \"times\": 4\n}")

	req, _ := http.NewRequest("PATCH", 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.patch("https://post.chatclean.com.br/api/posts/{post}/recurrence")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"interval\": 1,\n  \"frequency\": \"week\",\n  \"times\": 4\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"interval\": 1,\n  \"frequency\": \"week\",\n  \"times\": 4\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": "Agora dá para agendar fios no X. Veja como funciona.",
  "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": "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": {
    "interval": 1,
    "frequency": "week",
    "remaining": 4
  },
  "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-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 16:30:00"
}

{
  "message": "Unauthenticated."
}

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

{
  "message": "<string>"
}

{
  "message": "<string>"
}

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

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

Recorrência

Definir repetição do post

Faz um post agendado se repetir: a cada interval frequency, mais times vezes depois desta. Cada ocorrência mantém o mesmo horário local no fuso do canal. Uma regra nova substitui a anterior. O post precisa estar scheduled com horário, senão 422 em post: Só posts agendados podem se repetir. A última ocorrência precisa cair antes de 2038 no fuso de cada canal, senão 422 em times. Membros que precisam de aprovação recebem 403.

PATCH

posts

{post}

recurrence

Definir repetição do post

curl --request PATCH \
  --url https://post.chatclean.com.br/api/posts/{post}/recurrence \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "interval": 1,
  "frequency": "week",
  "times": 4
}
'

import requests

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

payload = {
    "interval": 1,
    "frequency": "week",
    "times": 4
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({interval: 1, frequency: 'week', times: 4})
};

fetch('https://post.chatclean.com.br/api/posts/{post}/recurrence', 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}/recurrence",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'interval' => 1,
    'frequency' => 'week',
    'times' => 4
  ]),
  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}/recurrence"

	payload := strings.NewReader("{\n  \"interval\": 1,\n  \"frequency\": \"week\",\n  \"times\": 4\n}")

	req, _ := http.NewRequest("PATCH", 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.patch("https://post.chatclean.com.br/api/posts/{post}/recurrence")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"interval\": 1,\n  \"frequency\": \"week\",\n  \"times\": 4\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"interval\": 1,\n  \"frequency\": \"week\",\n  \"times\": 4\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": "Agora dá para agendar fios no X. Veja como funciona.",
  "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": "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": {
    "interval": 1,
    "frequency": "week",
    "remaining": 4
  },
  "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-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 16:30:00"
}

{
  "message": "Unauthenticated."
}

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

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

interval

integer

required

Repete a cada N unidades de frequency.

Required range: 1 <= x <= 365

frequency

enum<string>

required

Unidade da repetição: dia, semana, mês ou ano.

Available options:

day,

week,

month,

year

times

integer

required

Quantas vezes o post se repete depois desta ocorrência.

Required range: 1 <= x <= 100

Response

O post com a regra de repetição.

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

Definir repetição do post

Authorizations

Path Parameters

Body

Response