---
title: "Preview Prism"
method: POST
path: "/v2/prisms/preview"
tags: ["Prisms Internal"]
---

# Preview Prism

`POST /v2/prisms/preview`

Compute a prism the exact way a refresh does, without publishing — so
CAMS can render the platform view of a draft before it goes live.

Stateless: always purchases and derives (the framework purchase dedups on
config, so a repeat preview prices to $0). CAMS holds the read-through
preview cache; ``cached`` is always False here and set by CAMS on its hits.

## Request body

- BodyPreviewPrismV2PrismsPreviewPost
  - `payload` PrismPreviewRequest, required — A prism definition to compute *without* publishing. ``prism_id`` is optional so an unsaved CAMS form can be previewed before it is saved. The read-through preview cache lives in CAMS, not here.
    - `prism_id` string, nullable
    - `title` string, required
    - `category` string, required
    - `question` string, nullable
    - `question_share` string, nullable
    - `insight_id` integer, required
    - `insight_label` string, required
    - `entities` PrismEntityRef[], required
      - `entity_id` integer, required — Carc entity id (representation-scoped)
      - `entity_representation` string, required
      - `entity_name` string, required
    - `location_resolution` string
    - `filters` object — Dimension filters from the framework's advertised set. Blank selections must be omitted, not sent as empty lists.
  - `config` object, nullable

## Response `200`

Successful Response

- PrismPreviewResponse — The exact snapshot entry the public page would render for this prism. ``cached`` is always False from power-api (stateless compute); CAMS sets it True when serving a repeat preview from its own cache.
  - `cached` boolean, required
  - `prism` object, required

## Other responses

- `404` — Not Found
- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-api-documentation.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-api-documentation/revisions/bd33ea42994c/schema)