Carousels & Infographics

Get carousel

Reads one carousel or infographic: per-slide text summaries, render/PDF readiness, and preview image URLs when rendered.

GET/api/public/carousels/:id

cURLGET /api/public/carousels/:id

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

200Response

{
  "success": true,
  "carousel": {
    "id": "car1...",
    "title": "5 Content Mistakes",
    "status": "draft",
    "postId": null
  },
  "format": "carousel",
  "versionId": "cv1...",
  "versionNumber": 1,
  "slideCount": 6,
  "slides": [
    {
      "index": 0,
      "title": "5 Content Mistakes",
      "textPreview": "..."
    }
  ],
  "rendered": false,
  "pdfReady": false,
  "pdfUrl": null,
  "slideImages": null,
  "openInPostivUrl": "https://postiv.ai/app/create?carouselId=car1..."
}

Authorization

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

Path parameters

idstringrequired

Resource id from the corresponding list or create endpoint.

Response

Carousel state and (if rendered) previews.

carousel.id / title / status / postId / createdAt / updatedAtmixed

formatstring

versionId / versionNumber / slideCountmixed

slides[].index / title / textPreviewmixed

renderedboolean

pdfReadyboolean

Always false for infographics.

pdfUrlstring|null

Signed URL, only for rendered carousels (never infographics).

slideImagesarray|null

[{ index, imageUrl }], null until rendered.

openInPostivUrlstring

Errors

404	carousel_not_found: wrong id, or owned outside this workspace
400	carousel_missing_versions: no saved versions (shouldn't normally happen)

Good to know

Slides are visual HTML internally; this only returns extracted text summaries: use render-carousel's slideImages for the actual visual.