Plans & Pillars

List content pillars

Lists the recurring content pillars an account's weekly plans draw from: summary shape only (name, description, mode, suggested day). An account with no pillars of its own, typically an X account linked to a LinkedIn profile, shows its social stack's shared pillars; pillarSource says which. Call get_pillar for full content + performance.

GET/api/public/pillars

cURLGET /api/public/pillars

curl "https://postiv.ai/api/public/pillars?integrationId=123" \
  -H "Authorization: Bearer pk_postiv_..."

200Response

{
  "success": true,
  "integrationId": 1234,
  "channel": "linkedin",
  "pillarSource": "account",
  "postsPerWeek": 4,
  "contentGoal": "leads",
  "pillars": [
    {
      "id": "pl1...",
      "name": "Content Strategy",
      "description": "Educational posts on planning content.",
      "mode": "evergreen",
      "suggestedDay": "Tuesday"
    }
  ]
}

Authorization

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

Query parameters

integrationIdintrequired

Account id (LinkedIn profile, company page or X account).

Response

Active pillars for the profile.

integrationIdint

channelstring

Channel of the account.

pillarSourcestring

Whose pillars these are: the account's own, its social stack's shared ones, or none.

postsPerWeekint|null

contentGoalstring|null

pillars[].iduuid

pillars[].namestring

pillars[].descriptionstring

pillars[].modestring

pillars[].suggestedDaystring|null

Errors

400	invalid_integration_id
404	integration_not_found: account not in this workspace