PUT/api/orgs/{org_id}/zero-data-retention

Turn account-wide zero data retention on or off

On: storage off, require_zdr and require_no_training true (allowlist kept), in one transaction. Routing then removes every rung that is not zero retention and no training, BYOK included, and a model with no qualifying rung is refused rather than served elsewhere. Zero data retention is Pro (403 needs_subscription). Off: both routing requirements cleared; storage is restored to its previous value only for an organization that is not Pro. Needs an org admin or the organization's own API key; a write that changes nothing is a no-op.

Authentication: Bearer API key in the Authorization header

Path parameters

  • org_idstringrequired

    Your organization id (uuid). GET /api/whoami returns it.

Request body

  • enabledbooleanrequired

Responses

  • 200

    The switch after the write.

    Response
    • org_idstringrequired
    • enabledbooleanrequired

      Storage off and both routing requirements on, with no exemption waiving them.

    • exemptionsarray<string>
    • partialbooleanrequired

      The switch was turned on but a granular change has drifted a fact.

    • enforced_atstring | nullrequired

      When the switch last turned zero data retention on; null when off.

    • factsobjectrequired
      facts
      • capture_prompt_contentbooleanrequired
      • require_zdrbooleanrequired
      • require_no_trainingbooleanrequired
      • zdr_continuation_storageboolean

        Read-only here; set through PUT /api/orgs/{org_id}/provider-policy.

        Default: false
    • allowed_providersarray | nullrequired

      The provider allowlist, untouched by the switch.

    • models_with_zdr_routeintegerrequired

      Public models with at least one zero-retention, no-training rung this organization's policy permits.

    • zdr_entitledbooleanrequired

      Whether this organization may turn the switch on (Pro or grandfathered).

  • 401

    Missing, unknown or revoked API key.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 403

    Zero data retention needs Pro (or a grandfathered organization), or the caller is a member below admin.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 404

    The resource does not exist or belongs to another organization.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 409

    Turning off would restore storage while an earlier erasure is unfinished; nothing changed.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 422

    The body or query failed validation.

    Response
    • detailarray<object>required
      detail
      • typestring
      • locarray<string | integer>
      • msgstring

Request

curl -X PUT https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/zero-data-retention \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "enabled": true
}'

Response

{
  "org_id": "3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10",
  "enabled": true,
  "exemptions": [],
  "partial": false,
  "enforced_at": "2026-11-19T11:06:40.221Z",
  "facts": {
    "capture_prompt_content": false,
    "require_zdr": true,
    "require_no_training": true,
    "zdr_continuation_storage": false
  },
  "allowed_providers": null,
  "models_with_zdr_route": 214,
  "zdr_entitled": true
}

https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/zero-data-retention