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

# Refresh Prism

`POST /v2/prisms/refresh`

Recompute one prism: purchase its framework as the Prism service
account (data restrictions and order-history observability apply), derive
the relative series, and return the snapshot entry. Stateless — CAMS
persists the result to its audit trail and serving cache.

## Request body

- BodyRefreshPrismV2PrismsRefreshPost
  - `payload` PrismRefreshRequest, required — One prism definition, pushed by CAMS (the source of truth) for recompute. The date window is derived here, never supplied — except ``as_of``, which may pin the window end to today (ET). Past-day repairs are not allowed.
    - `prism_id` string, required — CAMS prisms.id
    - `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.
    - `as_of` string, date, nullable
    - `skip_query_cache` boolean
  - `config` object, nullable

## Response `200`

Successful Response

- PrismRefreshResponse
  - `prism_id` string, required
  - `order_id` string, required
  - `framework_id` string, required
  - `total_price` number, required
  - `refreshed_at` string, date-time, required
  - `data_through` string, date, nullable
  - `window_start` string, date, required
  - `window_end` string, date, required
  - `compute_date` string, date, required
  - `snapshot` 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)