---
title: "Refresh All Prisms"
method: POST
path: "/api/v1/admin/prisms/refresh-all"
tags: ["Admin APIs", "prisms"]
---

# Refresh All Prisms

`POST /api/v1/admin/prisms/refresh-all`

Force a recompute of every live prism, bypassing the freshness gate.

The hourly gate only opens once every granted table's ``table_max_date``
advances, so a compute-side change can't reach the public page while
sources are idle — the last-good graphs keep serving indefinitely. This
is the operator escape hatch for that case.

Queues one ``task_refresh_prism`` per prism rather than computing inline:
each is a real purchase against the warehouse, and 20+ of them would run
well past any HTTP timeout. Outcomes land in the recompute-attempts log
like any other compute. Dispatched by name because ``prism_tasks``
imports from this module.

## Response `200`

Successful Response

- PrismRefreshAllResponse — Live prisms queued for a forced recompute. The work runs on Celery, so this is an enqueue count, not an outcome — outcomes land in the attempts log.
  - `queued` integer, required

---

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