Plans & Pillars

Get Bob content plan item

Reads one content-plan item in full detail, including the bounded knowledge/trending sources Bob saved when planning it.

GET/api/public/content-plan-items/:id

cURLGET /api/public/content-plan-items/:id

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

200Response

{
  "success": true,
  "item": {
    "id": "i1...",
    "planId": "p1...",
    "profileId": 1234,
    "weekStart": "2026-07-13",
    "position": 0,
    "topic": "Why most B2B content fails",
    "sourceChunks": [
      "Postiv customer research shows..."
    ],
    "contextItems": [],
    "research": null
  }
}

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 full plan item.

item.id / position / topic / angle / goal / hookPattern / targetDay / status / postId / carouselId / contentFormat / pillar

mixed

Same fields as list_content_plans items.

item.planIduuid

item.profileIdint

item.weekStartstring

item.sourceChunksstring[]

Up to 8 saved knowledge-base excerpts, each truncated to 2000 chars: use directly instead of re-searching knowledge.

item.contextItemsarray

Up to 12 { type, title, url } context references.

item.researchobject|null

When present: what the slot was planned from: a chosen fresh signal (source + suggested hook/format), remaining alternatives, or a sourced external object with signed media URLs to react to.

Errors

400	id path param must be a UUID
404	content_plan_item_not_found: item id not found or not in this workspace

Good to know

research.sourced media URLs are re-signed on every read via signSourcedMedia.