Skip to content

get_post

Fetches a single post by id, including per-profile delivery status, the live URL of each published copy, and the error for any profile that failed. This is how an agent answers “did it actually go out?”.

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

Parameters

id
stringrequired
ObjectId of the post.
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/get_post" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $POSTMCPAI_API_KEY" \
  -d '{
    "id": "66a50b12e4b019a2b71c"
  }'

Response

One post, in the same shape as an entry of list_posts.

200 · application/json
{
  "id": "66a50b12e4b019a2b71c",
  "content": "Building social automation with PostMCP AI 🤖",
  "status": "published",
  "targets": [
    {
      "platform": "linkedin",
      "profileId": "lin_9823412",
      "status": "published",
      "url": "https://linkedin.com/feed/update/urn:li:share:7218..."
    }
  ],
  "attempts": 1,
  "lastError": ""
}