Posta icon

Posta

Manage social media posts, media, accounts, analytics, and webhooks via the Posta API

Actions45

Post → Update

AI-generated

Summary

Updates an existing Posta post by sending a PATCH to /posts/{postId} with only the fields you set, including optional per-platform settings. Returns the API's updated post.

Inputs

  • Post ID (required) — ID of the post to update.
  • Update Fields — Collection of optional fields to change. Caption is sent whenever set, even if empty. Hashtags, Media IDs and Social Account IDs are comma-separated strings that are split and trimmed into arrays, and are skipped if empty. Scheduled At is normalized to UTC ISO 8601. If you add the field but leave it empty, it sends null to clear the schedule. Is Draft and Processing Enabled are booleans. Fields you don't add are left out of the request.
  • Platform Configurations — Single-selection group of platform-specific settings. Options are TikTok (privacy, comments, duet, stitch, title, AIGC and branded flags), Pinterest (board, link, alt text), YouTube (title, description, tags, privacy, short, made for kids), Instagram and Facebook (placement), X/Twitter (reply settings, quote tweet ID, alt text), LinkedIn (visibility, post type, document title), Bluesky (alt text, embed URL, languages, labels) and Threads (location). Comma-separated values such as YouTube tags, X alt text and Bluesky alt text, languages and labels are converted to arrays. Pinterest keys are sent as board_id and alt_text. Sent only if configured.

Output shape

A single item whose JSON is the updated post record returned by the Posta API.

The exact fields depend on the API response. Errors are wrapped as NodeApiError. With Continue On Fail enabled, the item's JSON is {error: message}. Invalid date values throw an error.

Examples

Example 1: Reschedule a post and change its caption

Post ID = {{$json.id}}; Update Fields: Caption = 'New text', Scheduled At = 2026-11-01T09:00:00Z

Example 2: Convert a scheduled post to a draft and clear its schedule

Post ID set; Update Fields: Is Draft = true, Scheduled At added but left empty

Example 3: Change YouTube privacy on an existing post

Post ID set; Platform Configurations → YouTube: Privacy Status = Unlisted, Tags = 'news,update'

Links

Discussion