Skip to content

update_post

Patches an existing post. Only the fields you send are changed — everything omitted keeps its current value. Supplying targetAccounts replaces the target list outright rather than adding to it.

On this page
  1. Parameters
  2. Example request
  3. Response
Category
Publishing
REST
POST/api/tools/update_post

Parameters

id
stringrequired
ObjectId of the post to update.
content
stringoptional
Replacement text body.
targetAccounts
array<object>optional
Replacement profile list. The post is re-pointed at exactly these profiles.
platform
enumrequired
linkedin · twitter · facebook · instagram · threads · bluesky · youtube
profileId
stringoptional
Id returned by get_connected_accounts.
username
stringoptional
Handle, carried through for readability.
platforms
array<enum>optional
Replacement network list; each network expands to all of its connected profiles.
scheduleDate
stringoptional
YYYY-MM-DD.
scheduleTime
stringoptional
HH:MM, 24-hour.
timezone
stringoptional
IANA zone for the schedule above.default: UTC
status
enumoptional
scheduled · draft · failed — use draft to pull a post out of the queue without deleting it.
workspaceId
stringoptional
Workspace to act on, from list_workspaces. Omit to use the default workspace on the key.

Example request

curl -X POST "https://api.postmcpai.com/api/tools/update_post" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $POSTMCPAI_API_KEY" \
  -d '{
    "id": "66a50c89e4b019a2b72f",
    "content": "Updated announcement with the launch link included. 🌟",
    "scheduleTime": "11:30",
    "timezone": "Asia/Kolkata"
  }'

Response

The post as it stands after the patch.

200 · application/json
{
  "success": true,
  "message": "Post updated successfully",
  "post": {
    "id": "66a50c89e4b019a2b72f",
    "content": "Updated announcement with the launch link included. 🌟",
    "scheduleDate": "2026-08-02",
    "scheduleTime": "11:30",
    "status": "scheduled"
  }
}