Update post

curl -X PUT https://app.trypost.it/api/posts/9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "publishing",
    "content": "New pin from the TryPost API",
    "platforms": [
      {
        "id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
        "content_type": "pinterest_pin",
        "meta": {
          "board_id": "1234567890123456789",
          "title": "Summer lookbook",
          "link": "https://example.com/shop/summer"
        }
      }
    ]
  }'

{
  "id": "9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
  "content": "New pin from the TryPost API",
  "media": [],
  "status": "publishing",
  "scheduled_at": "2025-01-15 10:30:00",
  "published_at": null,
  "platforms": [
    {
      "id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
      "platform": "pinterest",
      "content_type": "pinterest_pin",
      "meta": {
        "board_id": "1234567890123456789",
        "title": "Summer lookbook",
        "link": "https://example.com/shop/summer"
      },
      "status": "publishing",
      "enabled": true,
      "platform_url": null,
      "published_at": null,
      "error_message": null,
      "display_name": "Acme Brand",
      "display_username": "acme",
      "display_avatar": "https://i.pinimg.com/.../avatar.jpg",
      "social_account": {
        "id": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
        "platform": "pinterest",
        "display_name": "Acme Brand",
        "username": "acme",
        "is_active": true,
        "status": "connected"
      }
    }
  ],
  "labels": [],
  "created_at": "2025-01-14 09:00:00",
  "updated_at": "2025-01-14 09:30:00"
}

PUT

posts

{post}

curl -X PUT https://app.trypost.it/api/posts/9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "publishing",
    "content": "New pin from the TryPost API",
    "platforms": [
      {
        "id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
        "content_type": "pinterest_pin",
        "meta": {
          "board_id": "1234567890123456789",
          "title": "Summer lookbook",
          "link": "https://example.com/shop/summer"
        }
      }
    ]
  }'

{
  "id": "9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
  "content": "New pin from the TryPost API",
  "media": [],
  "status": "publishing",
  "scheduled_at": "2025-01-15 10:30:00",
  "published_at": null,
  "platforms": [
    {
      "id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
      "platform": "pinterest",
      "content_type": "pinterest_pin",
      "meta": {
        "board_id": "1234567890123456789",
        "title": "Summer lookbook",
        "link": "https://example.com/shop/summer"
      },
      "status": "publishing",
      "enabled": true,
      "platform_url": null,
      "published_at": null,
      "error_message": null,
      "display_name": "Acme Brand",
      "display_username": "acme",
      "display_avatar": "https://i.pinimg.com/.../avatar.jpg",
      "social_account": {
        "id": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
        "platform": "pinterest",
        "display_name": "Acme Brand",
        "username": "acme",
        "is_active": true,
        "status": "connected"
      }
    }
  ],
  "labels": [],
  "created_at": "2025-01-14 09:00:00",
  "updated_at": "2025-01-14 09:30:00"
}

Request

string

required

The post ID.

string

required

The post status. One of:

draft — keep as draft
scheduled — schedule for the time given in scheduled_at (must be in the future)
publishing — publish immediately: dispatches the publish job to all enabled platforms

Cross-validated: scheduled requires a scheduled_at in the future.

string

The post caption/text body (max 10 000 characters at the API level; per-platform hard caps still apply via GET /content-types). For Pinterest pins, this becomes the pin description (not meta.title).

array

Replace the post’s media set. Each item must include a public url — the API downloads and hosts it (same shape as POST /posts). Nested meta.alt_text (string, max 2000) is allowed for accessibility — that is media meta, not platforms[].meta.Prefer dedicated endpoints when practical: POST /posts/{post}/media (multipart file), POST /posts/{post}/media/from-url, or POST /posts/{post}/media/from-asset to reuse a library item.

array

An array of platform entries to enable. Any platform NOT listed here will be disabled. Pass an empty array to disable all.

Show child attributes

string

required

The post_platform entry ID (from GET /posts/{id} or GET /posts).

string

Override the content_type for this platform. Cross-validated against the social account’s platform. Discover the live catalog with GET /content-types.Allowed values: linkedin_post, linkedin_page_post, x_post, facebook_post, facebook_reel, facebook_story, instagram_feed, instagram_reel, instagram_story, tiktok_video, tiktok_photo, youtube_short, threads_post, pinterest_pin, pinterest_video_pin, pinterest_carousel, bluesky_post, mastodon_post, telegram_post, discord_message.There is no linkedin_carousel / instagram_carousel — use linkedin_post + PDF (and optional meta.document_title) for LinkedIn documents, and instagram_feed with multiple images for Instagram carousels.

object

Per-platform settings. See Per-platform meta below for the full contract.

string

ISO 8601 datetime. Required when status=scheduled.

array

An array of label UUIDs to assign to the post. Replaces existing labels.

Per-platform `meta`

platforms[].meta holds settings that only apply to one social account on the post. The same keys are accepted on POST /posts and by the MCP create/update tools.

Behaviour

Only the keys listed below are accepted. Unknown keys are dropped (they never persist).
On update, meta is merged into the platform’s existing object. Send a key as null to remove it (e.g. "title": null).
Required-to-publish keys are enforced on this request when status is scheduled or publishing and you include a platforms[] array in the body (each submitted row is checked). Drafts are not checked. A missing key returns 422 on platforms.{i}.meta.{field} (e.g. platforms.0.meta.channel_id).
If you publish with only { "status": "publishing" } (no platforms[]), this endpoint does not re-validate stored meta — ensure board_id / privacy_level / channel_id were saved earlier. The MCP publish-post-tool always validates stored meta before publishing.
Media compatibility is always re-checked on scheduled / publishing, with or without platforms[]: every enabled platform’s effective content_type is validated against the post’s effective media (media kind, GIF/MOV acceptance, byte cap via size, and video duration read from the file on upload). A failure is 422 on platforms.{i}.content_type, e.g. Video exceeds the 300 MB limit for this post type (yours is 900.0 MB). — see Media → Enforced on the server.
Enum-like fields are JSON strings — send the exact literal (e.g. "privacy_level": "PUBLIC_TO_EVERYONE"), not an integer or a different casing.
Platforms with no meta keys: X, YouTube, Threads, Bluesky, Mastodon, Telegram.

Instagram / Facebook

Key	Type	Required to publish?	Description
`aspect_ratio`	string	No	Crop ratio for feed-style posts. Exact values: `"1:1"`, `"4:5"`, `"16:9"`, `"original"`.

LinkedIn / LinkedIn Page

Key	Type	Required to publish?	Description
`document_title`	string (max 300)	No	Title shown on a PDF document post. If omitted, TryPost falls back to the PDF filename, then `"Document"`. Only used when the post has a PDF attached.

TikTok

Key	Type	Required to publish?	Applies to	Description
`privacy_level`	string	Yes	Video + photo	Exact values: `"PUBLIC_TO_EVERYONE"`, `"MUTUAL_FOLLOW_FRIENDS"`, `"FOLLOWER_OF_CREATOR"`, `"SELF_ONLY"`.
`allow_comments`	boolean	No	Video + photo	When `true`, comments are allowed. TryPost sends the inverted TikTok flag (`disable_comment`).
`allow_duet`	boolean	No	Video only	Ignored for `tiktok_photo`.
`allow_stitch`	boolean	No	Video only	Ignored for `tiktok_photo`.
`auto_add_music`	boolean	No	Photo only	Ignored for `tiktok_video`.
`is_aigc`	boolean	No	Video only	Marks the post as AI-generated content. Ignored for `tiktok_photo`.
`disclose`	boolean	No	Video + photo	Stored for branded-content UI. Not sent to TikTok’s API — use the `brand_*` toggles below for the actual disclosure.
`brand_content_toggle`	boolean	No	Video + photo	Paid partnership / branded content disclosure.
`brand_organic_toggle`	boolean	No	Video + photo	Your brand / organic promotional disclosure.

Example TikTok meta:

{
  "privacy_level": "PUBLIC_TO_EVERYONE",
  "allow_comments": true,
  "allow_duet": true,
  "allow_stitch": false,
  "is_aigc": false,
  "brand_content_toggle": false,
  "brand_organic_toggle": false
}

Key	Type	Required to publish?	Description
`board_id`	string	Yes	Target board. Resolve IDs with `GET /social-accounts/{account}/boards` (or MCP `list-pinterest-boards-tool`). At publish time, if `board_id` is missing, TryPost may fall back to the account’s dashboard default board — API/MCP callers should still set `board_id` explicitly.
`title`	string (max 100)	No	Pin title.
`link`	string (max 2048)	No	Destination URL. Must be `http` or `https`.

The pin description is the post content, not a meta field. Example Pinterest meta:

{
  "board_id": "1234567890123456789",
  "title": "Summer lookbook",
  "link": "https://example.com/shop/summer"
}

Discord

Key	Type	Required to publish?	Description
`channel_id`	string	Yes	Target text/announcement channel. Resolve IDs with `GET /social-accounts/{account}/channels` (or MCP `list-discord-channels-tool`).
`channel_name`	string	No	Display label only — not used when publishing.
`mentions`	array	No	Mention chips. Each item: `{ "token": string, "label"?: string }`. `token` is required.
`embeds`	array (max 10)	No	Rich embeds. Each item may include `title` (max 256), `description` (max 4096), `url`, `image` (image URL), `color` (`#RRGGBB` or `RRGGBB`).

Mention token formats (send these exact Discord markup strings):

Target	`token` example
Everyone	`"@everyone"`
Here	`"@here"`
User	`"<@123456789012345678>"`
Role	`"<@&987654321098765432>"`

There is no public REST endpoint to search Discord members/roles — construct tokens yourself (or use the dashboard mention picker). Example Discord meta:

{
  "channel_id": "444555666777888999",
  "channel_name": "announcements",
  "mentions": [
    { "token": "@everyone", "label": "@everyone" }
  ],
  "embeds": [
    {
      "title": "Launch day",
      "description": "We're live.",
      "url": "https://example.com",
      "image": "https://example.com/hero.png",
      "color": "#7c3aed"
    }
  ]
}

Response

Returns the updated post (including platforms[].meta). Returns 422 with a message when the post is already finalized and cannot be edited (published, publishing, partially_published, or failed). English copy: “This post has already been processed and cannot be re-published. Duplicate it to try again.”

curl -X PUT https://app.trypost.it/api/posts/9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "publishing",
    "content": "New pin from the TryPost API",
    "platforms": [
      {
        "id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
        "content_type": "pinterest_pin",
        "meta": {
          "board_id": "1234567890123456789",
          "title": "Summer lookbook",
          "link": "https://example.com/shop/summer"
        }
      }
    ]
  }'

{
  "id": "9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
  "content": "New pin from the TryPost API",
  "media": [],
  "status": "publishing",
  "scheduled_at": "2025-01-15 10:30:00",
  "published_at": null,
  "platforms": [
    {
      "id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
      "platform": "pinterest",
      "content_type": "pinterest_pin",
      "meta": {
        "board_id": "1234567890123456789",
        "title": "Summer lookbook",
        "link": "https://example.com/shop/summer"
      },
      "status": "publishing",
      "enabled": true,
      "platform_url": null,
      "published_at": null,
      "error_message": null,
      "display_name": "Acme Brand",
      "display_username": "acme",
      "display_avatar": "https://i.pinimg.com/.../avatar.jpg",
      "social_account": {
        "id": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
        "platform": "pinterest",
        "display_name": "Acme Brand",
        "username": "acme",
        "is_active": true,
        "status": "connected"
      }
    }
  ],
  "labels": [],
  "created_at": "2025-01-14 09:00:00",
  "updated_at": "2025-01-14 09:30:00"
}

Tips

To publish an existing draft, send { "status": "publishing" } — content/platforms already saved are kept. Required meta (board_id, privacy_level, channel_id) must already be stored; include platforms[] on this request if you want the API to 422 when a key is missing.
To schedule, send { "status": "scheduled", "scheduled_at": "2025-12-31T15:30:00Z" }.
To toggle which platforms are active without changing content, send only the platforms[] array.
Clear a meta field with null: { "meta": { "title": null, "link": null } }.

Overview

Posts

Platforms

Workspace

Assets

Signatures

Labels

Social Accounts

API Keys

Repurpose

Webhooks

Request

Per-platform `meta`

Behaviour

Instagram / Facebook

LinkedIn / LinkedIn Page

TikTok

Pinterest

Discord

Response

Tips

​Request

​Per-platform meta

​Behaviour

​Instagram / Facebook

​LinkedIn / LinkedIn Page

​TikTok

​Pinterest

​Discord

​Response

​Tips

Request

Per-platform `meta`

Behaviour

Instagram / Facebook

LinkedIn / LinkedIn Page

TikTok

Pinterest

Discord

Response

Tips