Change a planned Instagram post
const url = 'https://app.whatsetter.com/api/v1/instagram/posts/example';const options = { method: 'PATCH', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"publish_at":"2027-01-13T18:00:00Z"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PATCH \ --url https://app.whatsetter.com/api/v1/instagram/posts/example \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "publish_at": "2027-01-13T18:00:00Z" }'Changes the caption, the time (publish_at, an instant; null =
now), the first comment (null removes it), the comment automation
(null removes it), the trial setting, the options
(collaborators, user_tags, audio_name, share_to_feed,
comments_enabled; each one sent replaces its value), facebook or mode of a post
still waiting for its time. Its media (and their alt texts) stay. A post already on its way to Instagram
answers 409 post_already_started, one already published 409 post_already_published; a time already past is refused (422).
publish_at: null publishes it within a minute and facebook: true
adds a public post on the Page. Switching to mode: remind (or
sending remind_member_id) names the member reminded, as on create.
Requires scope instagram:write.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”A planned post (from listInstagramPosts or createInstagramPost).
Request Bodyrequired
Section titled “Request Bodyrequired”object
object
object
Mode remind: the team member reminded (GET /team/members).
Example
{ "publish_at": "2027-01-13T18:00:00Z"}Responses
Section titled “Responses”Changed
object
object
object
The URL given through the API; null for a file uploaded from the dashboard.
The comment automation made on the post once it is live. A post planned in the dashboard may carry a whole automation built in its editor (link, follow ask, who continues…): it is summed up here as its first word (empty when it answers every comment) and its private message. Sending automation replaces it with this simple shape.
object
Posted one step after the post is live; a failure never takes the post back.
object
Comment_needs_reconnect, account_restricted, comment_refused, comment_gave_up, comment_no_media
A trial reel (shown first to non-followers).
object
Each media’s alternative text
False when the comments are turned off once it is live.
When the person was reminded (mode remind).
The copy on the linked Facebook Page; its outcome never touches the Instagram post’s.
object
Fb_permission, fb_reconnect, fb_reel_limit, fb_reel_duration, fb_reel_ratio, fb_photo_refused, fb_carousel_video, fb_processing_timeout, fb_unconfirmed…
Example
{ "data": { "kind": "image", "media": [ { "type": "image" } ], "status": "scheduled", "first_comment": { "status": "pending" }, "mode": "auto", "facebook": { "status": "pending" }, "source": "app" }}Missing, unknown or revoked API key
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}The key lacks the required scope (insufficient_scope), the plan does not have this part of the API (not_in_plan), or Instagram is not enabled on the workspace (instagram_not_enabled, Instagram routes)
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}Resource not found in this workspace
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}The post is already on its way to Instagram (post_already_started) or already published (post_already_published); or, switched back to mode: auto, the account must be reconnected to publish (instagram_reconnect_required); or the Facebook Page is missing or does not allow publishing (facebook_page_required, facebook_reconnect_required, facebook_permission_required).
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}validation_error, or no_reminder_recipient (mode remind and nobody of the workspace to remind).
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}facebook or the remind mode is not available on this workspace yet (instagram_publishing_unavailable).
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}