Skip to content
PostMCP/ai

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?”.

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

Parameters

id
stringrequired
ObjectId of the post.
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/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": ""
}