Skip to content

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.

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

Parameters

id
stringrequired
ObjectId of the stuck post.
force
booleanoptional
Reset even if the run may still be in flight. Refused without this within the stuck threshold.default: false
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/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"
  }
}