Plans & Pillars

Get content pillar

Reads one pillar in full: name, description, freeform content, suggested day, mode, version, and 30-day performance vs. the profile average when the pillar has published posts in that window.

GET/api/public/pillars/:id

cURLGET /api/public/pillars/:id

curl "https://postiv.ai/api/public/pillars/ID_ID" \
  -H "Authorization: Bearer pk_postiv_..."

200Response

{
  "success": true,
  "pillar": {
    "id": "pl1...",
    "name": "Content Strategy",
    "description": "...",
    "content": "Write about planning frameworks...",
    "suggestedDay": "Tuesday",
    "mode": "evergreen",
    "version": 3,
    "stats": {
      "postsPublished": 4,
      "avgImpressions": 5200,
      "engagementRateVsAverage": 1.15
    }
  }
}

Authorization

Requires an organization API key with the plans:read scope, sent as Authorization: Bearer or x-api-key.

Path parameters

idstringrequired

Resource id from the corresponding list or create endpoint.

Response

The pillar with performance stats.

pillar.id / name / description / suggestedDay / modemixed

pillar.contentstring

Freeform guidance on what to cover and how to write for this pillar.

pillar.versionint

pillar.statsobject|null

30-day performance (posts published, avg impressions, engagement rate vs. profile average, top posts); null if no published posts in that window.

Errors

400	id path param must be a UUID
404	pillar_not_found: pillar archived, doesn't exist, or not in this workspace