Skip to content
PostMCP/ai

reset_stuck_post

A post left in processing is invisible to the scheduler and refused by publish_post_now. This releases the lock so it can be retried. Profiles that already went out keep their delivered state, so retrying afterwards does not post twice.

Access
write
Category
Publishing
Endpoint
POST/api/tools/reset_stuck_post
On this page
  1. Parameters
  2. Example request
  3. Response

Parameters

id
stringrequired
ObjectId of the stuck post.
force
boolean
Reset even if the run may still be in flight. Refused without this within the stuck threshold.default: false
workspaceId
string
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/reset_stuck_post" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $POSTMCPAI_API_KEY" \
  -d '{
    "id": "66a50c89e4b019a2b72f"
  }'

Response

The released post, moved to published if any profile was delivered, otherwise failed.

200 · application/json
{
  "message": "Post reset. 1 profile(s) had already been delivered and were kept.",
  "post": {
    "id": "66a50c89e4b019a2b72f",
    "status": "published"
  }
}