Update post

curl --request PUT \
  --url https://app.trypost.it/api/posts/{post} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "We just shipped scheduled threads (and a few fixes).",
  "status": "scheduled",
  "queue": "next",
  "meta": {
    "thread_replies": [
      {
        "text": "2/ Replies publish under the first post."
      },
      {
        "text": "3/ Full changelog below.",
        "media": [
          {
            "id": "9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f"
          }
        ]
      }
    ]
  }
}
'

import requests

url = "https://app.trypost.it/api/posts/{post}"

payload = {
    "content": "We just shipped scheduled threads (and a few fixes).",
    "status": "scheduled",
    "queue": "next",
    "meta": { "thread_replies": [
            { "text": "2/ Replies publish under the first post." },
            {
                "text": "3/ Full changelog below.",
                "media": [{ "id": "9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f" }]
            }
        ] }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    content: 'We just shipped scheduled threads (and a few fixes).',
    status: 'scheduled',
    queue: 'next',
    meta: {
      thread_replies: [
        {text: '2/ Replies publish under the first post.'},
        {
          text: '3/ Full changelog below.',
          media: [{id: '9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f'}]
        }
      ]
    }
  })
};

fetch('https://app.trypost.it/api/posts/{post}', 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://app.trypost.it/api/posts/{post}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'content' => 'We just shipped scheduled threads (and a few fixes).',
    'status' => 'scheduled',
    'queue' => 'next',
    'meta' => [
        'thread_replies' => [
                [
                                'text' => '2/ Replies publish under the first post.'
                ],
                [
                                'text' => '3/ Full changelog below.',
                                'media' => [
                                                                [
                                                                                                                                'id' => '9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f'
                                                                ]
                                ]
                ]
        ]
    ]
  ]),
  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://app.trypost.it/api/posts/{post}"

	payload := strings.NewReader("{\n  \"content\": \"We just shipped scheduled threads (and a few fixes).\",\n  \"status\": \"scheduled\",\n  \"queue\": \"next\",\n  \"meta\": {\n    \"thread_replies\": [\n      {\n        \"text\": \"2/ Replies publish under the first post.\"\n      },\n      {\n        \"text\": \"3/ Full changelog below.\",\n        \"media\": [\n          {\n            \"id\": \"9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f\"\n          }\n        ]\n      }\n    ]\n  }\n}")

	req, _ := http.NewRequest("PUT", 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.put("https://app.trypost.it/api/posts/{post}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"content\": \"We just shipped scheduled threads (and a few fixes).\",\n  \"status\": \"scheduled\",\n  \"queue\": \"next\",\n  \"meta\": {\n    \"thread_replies\": [\n      {\n        \"text\": \"2/ Replies publish under the first post.\"\n      },\n      {\n        \"text\": \"3/ Full changelog below.\",\n        \"media\": [\n          {\n            \"id\": \"9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f\"\n          }\n        ]\n      }\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.trypost.it/api/posts/{post}")

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

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"content\": \"We just shipped scheduled threads (and a few fixes).\",\n  \"status\": \"scheduled\",\n  \"queue\": \"next\",\n  \"meta\": {\n    \"thread_replies\": [\n      {\n        \"text\": \"2/ Replies publish under the first post.\"\n      },\n      {\n        \"text\": \"3/ Full changelog below.\",\n        \"media\": [\n          {\n            \"id\": \"9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f\"\n          }\n        ]\n      }\n    ]\n  }\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": "We just shipped scheduled threads (and a few fixes).",
  "media": [
    {
      "id": "9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
      "path": "medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
      "url": "https://media.trypost.it/medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
      "type": "image",
      "mime_type": "image/jpeg",
      "original_filename": "launch.jpg",
      "size": 482113,
      "meta": {
        "width": 1080,
        "height": 1350,
        "alt_text": "Product launch banner"
      }
    }
  ],
  "status": "scheduled",
  "schedule_mode": "queue",
  "scheduled_at": "2026-10-13 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-5a6b7c8d9e10",
      "platform": "x",
      "content_type": "x_post",
      "meta": {
        "thread_replies": [
          {
            "text": "2/ Replies publish under the first post.",
            "media": []
          },
          {
            "text": "3/ Full changelog below.",
            "media": [
              {
                "id": "9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
                "path": "medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
                "url": "https://media.trypost.it/medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
                "type": "image",
                "mime_type": "image/jpeg",
                "original_filename": "launch.jpg",
                "size": 482113,
                "meta": {
                  "width": 1080,
                  "height": 1350,
                  "alt_text": "Product launch banner"
                }
              }
            ]
          }
        ]
      },
      "status": "pending",
      "enabled": true,
      "platform_url": null,
      "published_at": null,
      "error_message": null,
      "display_name": "TryPost",
      "display_username": "trypostit",
      "display_avatar": "https://pbs.twimg.com/profile_images/1790000000000000000/avatar_400x400.jpg",
      "social_account": {
        "id": "9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54",
        "platform": "x",
        "display_name": "TryPost",
        "username": "trypostit",
        "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": "Launch",
      "color": "#2563EB",
      "created_at": "2026-09-01 10:00:00",
      "updated_at": "2026-09-01 10:00:00"
    }
  ],
  "created_at": "2026-10-08 13:20:11",
  "updated_at": "2026-10-08 15:41:07"
}

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

Posts

Update post

Updates a post. Only the fields you send change. The social account is fixed (social_account_id is refused).

Send the destination’s format and settings either as top-level content_type and meta (the post has one destination), or as platforms[] with the destination id. meta is merged with the stored settings: send null for a key to clear it (string, list and object settings; boolean settings cannot be cleared, so send true or false); thread_replies replaces the whole list. media replaces the post’s media; label_ids replaces its labels.

status: publishing publishes the post now; scheduled schedules it at scheduled_at, in the queue (queue), or keeps its future scheduled_at; draft unschedules it (it is no longer published; the last scheduled_at stays on the draft). When scheduling or publishing, the content type must fit the media and the required settings must be present.

Posts that are publishing, published, partially published or failed cannot be edited: the request returns 422 with This post has already been processed and cannot be re-published. Duplicate it to try again.

Posts with several destinations (created before each channel got its own post) cannot be queued; platforms there lists the destinations to keep, and the rest are turned off. On this endpoint an invalid body may answer 422 before the 404 check of a post of another workspace.

PUT

posts

{post}

Update post

curl --request PUT \
  --url https://app.trypost.it/api/posts/{post} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "We just shipped scheduled threads (and a few fixes).",
  "status": "scheduled",
  "queue": "next",
  "meta": {
    "thread_replies": [
      {
        "text": "2/ Replies publish under the first post."
      },
      {
        "text": "3/ Full changelog below.",
        "media": [
          {
            "id": "9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f"
          }
        ]
      }
    ]
  }
}
'

import requests

url = "https://app.trypost.it/api/posts/{post}"

payload = {
    "content": "We just shipped scheduled threads (and a few fixes).",
    "status": "scheduled",
    "queue": "next",
    "meta": { "thread_replies": [
            { "text": "2/ Replies publish under the first post." },
            {
                "text": "3/ Full changelog below.",
                "media": [{ "id": "9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f" }]
            }
        ] }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    content: 'We just shipped scheduled threads (and a few fixes).',
    status: 'scheduled',
    queue: 'next',
    meta: {
      thread_replies: [
        {text: '2/ Replies publish under the first post.'},
        {
          text: '3/ Full changelog below.',
          media: [{id: '9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f'}]
        }
      ]
    }
  })
};

fetch('https://app.trypost.it/api/posts/{post}', 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://app.trypost.it/api/posts/{post}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'content' => 'We just shipped scheduled threads (and a few fixes).',
    'status' => 'scheduled',
    'queue' => 'next',
    'meta' => [
        'thread_replies' => [
                [
                                'text' => '2/ Replies publish under the first post.'
                ],
                [
                                'text' => '3/ Full changelog below.',
                                'media' => [
                                                                [
                                                                                                                                'id' => '9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f'
                                                                ]
                                ]
                ]
        ]
    ]
  ]),
  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://app.trypost.it/api/posts/{post}"

	payload := strings.NewReader("{\n  \"content\": \"We just shipped scheduled threads (and a few fixes).\",\n  \"status\": \"scheduled\",\n  \"queue\": \"next\",\n  \"meta\": {\n    \"thread_replies\": [\n      {\n        \"text\": \"2/ Replies publish under the first post.\"\n      },\n      {\n        \"text\": \"3/ Full changelog below.\",\n        \"media\": [\n          {\n            \"id\": \"9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f\"\n          }\n        ]\n      }\n    ]\n  }\n}")

	req, _ := http.NewRequest("PUT", 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.put("https://app.trypost.it/api/posts/{post}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"content\": \"We just shipped scheduled threads (and a few fixes).\",\n  \"status\": \"scheduled\",\n  \"queue\": \"next\",\n  \"meta\": {\n    \"thread_replies\": [\n      {\n        \"text\": \"2/ Replies publish under the first post.\"\n      },\n      {\n        \"text\": \"3/ Full changelog below.\",\n        \"media\": [\n          {\n            \"id\": \"9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f\"\n          }\n        ]\n      }\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.trypost.it/api/posts/{post}")

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

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"content\": \"We just shipped scheduled threads (and a few fixes).\",\n  \"status\": \"scheduled\",\n  \"queue\": \"next\",\n  \"meta\": {\n    \"thread_replies\": [\n      {\n        \"text\": \"2/ Replies publish under the first post.\"\n      },\n      {\n        \"text\": \"3/ Full changelog below.\",\n        \"media\": [\n          {\n            \"id\": \"9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f\"\n          }\n        ]\n      }\n    ]\n  }\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": "We just shipped scheduled threads (and a few fixes).",
  "media": [
    {
      "id": "9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
      "path": "medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
      "url": "https://media.trypost.it/medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
      "type": "image",
      "mime_type": "image/jpeg",
      "original_filename": "launch.jpg",
      "size": 482113,
      "meta": {
        "width": 1080,
        "height": 1350,
        "alt_text": "Product launch banner"
      }
    }
  ],
  "status": "scheduled",
  "schedule_mode": "queue",
  "scheduled_at": "2026-10-13 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-5a6b7c8d9e10",
      "platform": "x",
      "content_type": "x_post",
      "meta": {
        "thread_replies": [
          {
            "text": "2/ Replies publish under the first post.",
            "media": []
          },
          {
            "text": "3/ Full changelog below.",
            "media": [
              {
                "id": "9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
                "path": "medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
                "url": "https://media.trypost.it/medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
                "type": "image",
                "mime_type": "image/jpeg",
                "original_filename": "launch.jpg",
                "size": 482113,
                "meta": {
                  "width": 1080,
                  "height": 1350,
                  "alt_text": "Product launch banner"
                }
              }
            ]
          }
        ]
      },
      "status": "pending",
      "enabled": true,
      "platform_url": null,
      "published_at": null,
      "error_message": null,
      "display_name": "TryPost",
      "display_username": "trypostit",
      "display_avatar": "https://pbs.twimg.com/profile_images/1790000000000000000/avatar_400x400.jpg",
      "social_account": {
        "id": "9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54",
        "platform": "x",
        "display_name": "TryPost",
        "username": "trypostit",
        "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": "Launch",
      "color": "#2563EB",
      "created_at": "2026-09-01 10:00:00",
      "updated_at": "2026-09-01 10:00:00"
    }
  ],
  "created_at": "2026-10-08 13:20:11",
  "updated_at": "2026-10-08 15:41:07"
}

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

Workspace API key from Settings → API Keys.

Path Parameters

post

string<uuid>

required

Post id. A post of another workspace returns 404.

Body

application/json

content

string | null

Post text, at most 25000 characters. When status is scheduled or publishing it must also fit each account's limit (max_content_length of the social account, for example 280 on X or 25000 for X accounts with long posts, 300 on Bluesky, 500 on Mastodon including the content warning), measured on the text the network receives. A scheduled or published post needs text or media.

Maximum string length: 25000

media

object[]

Replaces the post's media. Omit it to keep the current media. Media in order. Each item is one of upload_token, url or id. Types the channel does not accept are refused.

Show child attributes

status

enum<string>

draft keeps the post editable. scheduled schedules it at scheduled_at or in the channel queue (queue). publishing publishes it now. Omit it to keep the current status.

Available options:

draft,

scheduled,

publishing

content_type

enum<string>

New format for the post's destination. Omitted, the stored format is kept, except on Pinterest and TikTok where new media decides it as on create.

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

Response

The updated post.

A post on one channel. Posts created together from several channels are independent posts that share a post_group_id.

string<uuid>

post_group_id

string<uuid> | null

Shared by the posts created in one batch.

author

object | null

A workspace member. Only the id and name are exposed.

Show child attributes

content

string | null

Post text, stored as sent (posts written in the app hold the editor's HTML).

media

object[] | null

Show child attributes

status

enum<string>

pending_approval is a post a member who needs approval asked to schedule or publish.

Available options:

draft,

pending_approval,

scheduled,

publishing,

published,

partially_published,

failed

schedule_mode

enum<string> | null

queue: the post holds a slot of the channel's posting schedule. custom: it is scheduled at its own time.

Available options:

queue,

custom,

null

scheduled_at

string | null

UTC, format Y-m-d H:i:s.

published_at

string | null

UTC, format Y-m-d H:i:s.

approval_requested_by

object | null

Who asked for approval (not always the author).

Show child attributes

approval_requested_at

string | null

UTC, format Y-m-d H:i:s.

approved_by

object | null

A workspace member. Only the id and name are exposed.

Show child attributes

approved_at

string | null

UTC, format Y-m-d H:i:s.

recurrence

object | null

Repeat rule, or null.

Show child attributes

origin

enum<string>

network for posts imported from the network (published outside TryPost).

Available options:

trypost,

network

platforms

object[]

Show child attributes

labels

object[]

Show child attributes

created_at

string

UTC, format Y-m-d H:i:s.

updated_at

string

UTC, format Y-m-d H:i:s.

Overview

Posts

Post notes

Approvals

Recurrence

Media and uploads

Social accounts

Channels

Ideas

Idea stages

Analytics

Labels

Signatures

Workspace

API keys

Webhooks

Repurposes

Platform

Update post

Authorizations

Path Parameters

Body

Response