Sign in

v4

latestOpenAPI 3.1.02026-08-02261331761.5 KB
Policy Decision Points

Refresh PDP data

Triggers an out-of-band data refresh for the PDP container with id pdp_id.

Publishes an OPAL data update instructing the PDP to immediately re-pull its full authorization data, instead of waiting for the next periodic poll.

post/v2/pdps/{proj_id}/{env_id}/configs/{pdp_id}/refresh

Path parameters

proj_idstring required

Either the unique id of the project, or the URL-friendly key of the project (i.e: the "slug").

Either the unique id of the project, or the URL-friendly key of the project (i.e: the "slug").

env_idstring required

Either the unique id of the environment, or the URL-friendly key of the environment (i.e: the "slug").

Either the unique id of the environment, or the URL-friendly key of the environment (i.e: the "slug").

pdp_idstring uuid required

The unique id of the pdp

The unique id of the pdp

Request body

reasonstring

Optional human-readable reason for the refresh, propagated to the OPAL DataUpdate and visible in PDP/OPAL logs.

shard_idinteger

For sharded PDPs, target only this shard. When omitted, the refresh targets the PDP's main topic (all shards).

Response

Successful Response

update_idstring 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_idsstring[] required

The ids of the PDP configurations that were targeted by this refresh.