Updating Posts

Modify an existing post—whether scheduled or already published—across your social networks. This endpoint handles network-specific constraints and supports advanced features like recycling and recurring schedules.

Requirements

• Authentication: Bearer API token

• Scope: posts

• Headers:

  • Authorization: Bearer-API YOUR_API_KEY

  • Publer-Workspace-Id: YOUR_WORKSPACE_ID

Endpoint

Updates an existing post by ID. The behavior differs depending on whether the post is scheduled or already published.

PUT /api/v1/posts/:id

Parameter Reference

Media Parameters

Each media object can include:

• id (string): Media ID

• path (string): Path to the media file

• title (string): Title of the media

• caption (string): Caption for the media

• in_library (boolean): Whether to save the media in the library

• default_thumbnail (string): Default thumbnail for videos

• thumbnails (object): Thumbnail information with real and small sizes

• user_tags (array): User tags in the media with position coordinates

• collaborator_tags (array): Collaborator tags in the media with position coordinates

• product_tags (array): Product tags in the media with position coordinates

Link Parameters

The link object can include:

• url (string): URL of the link

• call_to_action (string): Call to action text

• phone_number (string): Phone number for call to action

• provider_display (string): Provider display information

• original_description (string): Original description from the link

• original_title (string): Original title from the link

• description (string): Custom description for the link

• title (string): Custom title for the link

• default_image (string): Default image for the link

• images (array): Images for the link

• original_images (array): Original images from the link

Details Parameters

The details object can include:

• type (string): Type of post details (e.g., 'story')

• feed (boolean): Whether to share to feed (for Instagram reels)

• reminder (boolean): Whether the post is a reminder

• title (string): Title for event posts

• start (string): Start time for event posts

• end (string): End time for event posts

• coupon (string): Coupon code for offer posts

• terms (string): Terms for offer posts

• audio (string): Audio information

• privacy (string): Privacy setting

• comment (boolean): Whether to allow comments

• duet (boolean): Whether to allow duets (TikTok)

• stitch (boolean): Whether to allow stitches (TikTok)

• promotional (boolean): Whether the post is promotional

• paid (boolean): Whether the post is paid

• language (string): Language of the post

• auto_add_music (boolean): Whether to automatically add music

• text_format_preset_id (string): Text format preset ID

• boost (boolean): Whether to boost the post

Recycling Parameters

The recycling object can include:

• solo (boolean): Whether to recycle as solo

• gap (integer): Gap between recycling

• gap_freq (string): Frequency of the gap (e.g., 'days', 'weeks')

• label (string): Label for recycling

• start_date (string): Start date for recycling

• expire_date (string): Expiration date for recycling

• expire_count (integer): Number of times to recycle before expiring

Recurring Parameters

The recurring object can include:

• start_date (string): Start date for recurring posts

• end_date (string): End date for recurring posts

• repeat (string): Repeat frequency (e.g., 'daily', 'weekly')

• repeat_rate (integer): Rate of repetition

• days_of_week (array): Days of the week for weekly recurring posts

Other Parameters

Special Cases

When the post is published, you can only update network-specific params.

Networks Not Supporting Published Post Updates

For the following networks, only labels can be updated in Publer's database after a post is published:

• Twitter/X (polls cannot be edited after publishing)

• Pinterest

• Instagram

• Threads

• Bluesky

Scheduled Posts

For scheduled posts, all fields can be updated regardless of the target social network.

Recurring Posts

If the post is a recurring post, the update will be applied to all future child posts in the recurring series. Already published child posts will not be affected.

Notes

• When updating a post that requires approval, a notification will be sent to the appropriate workspace members.

• Changes to published posts will be reflected both in Publer's database and on the social media platform (for supported networks).

Related Resources

• List Posts API - Retrieve and filter posts

• Accounts API - Manage social media accounts

• Media API - Upload and manage media for posts