---
title: "Refresh data for all PDPs in the environment"
method: POST
path: "/v2/pdps/{proj_id}/{env_id}/configs/refresh"
tags: ["Policy Decision Points"]
---

# Refresh data for all PDPs in the environment

`POST /v2/pdps/{proj_id}/{env_id}/configs/refresh`

Triggers an out-of-band data refresh for **all** PDPs in the environment.

Publishes an OPAL data update instructing each PDP to immediately re-pull its
full authorization data, instead of waiting for the next periodic poll. Use
this to propagate external-data-source-backed changes in realtime.

`shard_id` is not accepted here: sharding is a per-PDP topology, so a single
shard target is meaningless across a heterogeneous environment. Target a shard
via the single-PDP endpoint (`POST .../configs/{pdp_id}/refresh`) instead.

## Path parameters

- `proj_id` string, required — Either the unique id of the project, or the URL-friendly key of the project (i.e: the "slug").
- `env_id` string, required — Either the unique id of the environment, or the URL-friendly key of the environment (i.e: the "slug").

## Request body

- PDPDataRefreshRequest
  - `reason` string — Optional human-readable reason for the refresh, propagated to the OPAL DataUpdate and visible in PDP/OPAL logs.
  - `shard_id` integer — For sharded PDPs, target only this shard. When omitted, the refresh targets the PDP's main topic (all shards).

## Response `200`

Successful Response

- PDPDataRefreshResponse
  - `update_id` string, uuid, required — The id of the generated OPAL DataUpdate. It is injected as the X-Permit-Update-Id header and surfaced in PDP/OPAL logs for correlation. Because the refresh is a full-data reload (dst_path=""), the PDP confirms it by advancing PDPInstance.current_data_date once the new bundle is fetched and saved (most_recent_data_fetch_id is only set for scoped/delta updates).
  - `pdp_ids` string[], required — The ids of the PDP configurations that were targeted by this refresh.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/permit/apis/permit-io-api.md) · [All operations](https://skmtc.dev/permit/apis/permit-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/permit/permit-io-api/revisions/0235743bf8a2/schema)