/api/orgs/{org_id}/provider-policyUpdate the provider data-control policy
A partial document: omitted fields keep their stored value, so concurrent writers do not overwrite each other. require_no_training and prompt_caching are available to every organization; turning require_zdr or zdr_continuation_storage on needs Pro (403 needs_subscription); a new or changed allowed_providers list needs the Enterprise data-controls capability (403 enterprise_required, a field refusal: resend the current list or null). While the account-wide zero-data-retention switch is on, lowering either requirement is refused with 409 zdr_switch_enforced. Needs an org admin or the organization's own API key. A refused document changes nothing.
Authentication: Bearer API key in the Authorization header
Path parameters
org_idstringrequiredYour organization id (uuid).
GET /api/whoamireturns it.
Request body
allowed_providersarray | nullA new or changed list needs the Enterprise data-controls capability. Null clears the allowlist; resending the current list is always allowed. Every token must appear in the posture matrix.
require_zdrbooleanTurning on needs Pro.
require_no_trainingbooleanAvailable to every organization.
allowed_processing_regionsarray | nullReplaces the stored list when sent; null clears it.
exemptionsarray<string>At most 64 distinct targets.
zdr_continuation_storagebooleanTurning on needs Pro.
prompt_cachingbooleanAvailable to every organization.
Responses
200The policy after the write.
Response
org_idstringrequiredpolicyobject | nullrequiredNull when no policy is set.
One of
object
org_idstringrequiredallowed_providersarray | nullrequiredProvider allowlist; null allows every provider.
require_zdrbooleanrequiredRoute only to zero-data-retention rungs.
require_no_trainingbooleanrequiredRoute only to rungs whose provider does not train on API data.
allowed_processing_regionsarray | nullrequiredISO country codes where processing may happen; null is unrestricted.
exemptionsarray<string>zdr_continuation_storagebooleanrequiredWhether zero-retention-routed Responses requests may keep
previous_response_idstate on the platform (off refuses them with 400zdr_continuation_disabled).prompt_cachingbooleanrequiredFalse turns prompt caching off across providers.
created_bystring | nullrequiredUser id; null when written with an API key.
updated_bystring | nullrequiredUser id; null when written with an API key.
created_atstringrequiredupdated_atstringrequired
exempt_deployment_idsarray<string>Lane ids the stored exemptions cover (display only). Empty on a PUT response.
zdr_entitledbooleanrequiredWhether this organization may turn
require_zdron (Pro, grandfathered, or already holding it).
400A boolean field was sent as null, the allowlist names a provider outside the posture matrix, or an exemption names an unknown provider or a model this organization cannot see.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
401Missing, unknown or revoked API key.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
403needs_subscription: turning onrequire_zdrorzdr_continuation_storageneeds Pro.enterprise_required: authoring a provider allowlist needs the Enterprise capability. An org member below admin also gets 403.Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
404The resource does not exist or belongs to another organization.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
409The account-wide zero-data-retention switch holds both requirements.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
422The body failed validation (unknown field, malformed region or exemption), or
allowed_providerswas an empty list (send null to allow every provider).
Request
curl -X PUT https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider-policy \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"require_zdr": true,
"require_no_training": true
}'Response
{
"org_id": "3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10",
"policy": {
"org_id": "3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10",
"allowed_providers": null,
"require_zdr": true,
"require_no_training": true,
"allowed_processing_regions": null,
"exemptions": [],
"zdr_continuation_storage": false,
"prompt_caching": true,
"created_by": null,
"updated_by": null,
"created_at": "2026-11-03T16:20:11.402Z",
"updated_at": "2026-11-19T11:02:03.117Z"
},
"exempt_deployment_ids": [],
"zdr_entitled": true
}https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider-policy