Plans & Pillars

List content pillars

Lists the recurring content pillars a profile's weekly plans draw from: summary shape only (name, description, mode, suggested day). 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,
  "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

Response

Active pillars for the profile.

integrationIdint

postsPerWeekint|null

contentGoalstring|null

pillars[].iduuid

pillars[].namestring

pillars[].descriptionstring

pillars[].modestring

pillars[].suggestedDaystring|null

Errors

400	invalid_integration_id
404	linkedin_profile_not_found