PUT/api/orgs/{org_id}/provider-policy

Update 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.

認証: AuthorizationヘッダーにBearer形式のAPIキー

パスパラメータ

  • org_idstring必須

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

リクエストボディ

  • allowed_providersarray | null

    A 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_zdrboolean

    Turning on needs Pro.

  • require_no_trainingboolean

    Available to every organization.

  • allowed_processing_regionsarray | null

    Replaces the stored list when sent; null clears it.

  • exemptionsarray<string>

    At most 64 distinct targets.

  • zdr_continuation_storageboolean

    Turning on needs Pro.

  • prompt_cachingboolean

    Available to every organization.

レスポンス

  • 200

    The policy after the write.

    レスポンス
    • org_idstring必須
    • policyobject | null必須

      Null when no policy is set.

      いずれか

      object

      • org_idstring必須
      • allowed_providersarray | null必須

        Provider allowlist; null allows every provider.

      • require_zdrboolean必須

        Route only to zero-data-retention rungs.

      • require_no_trainingboolean必須

        Route only to rungs whose provider does not train on API data.

      • allowed_processing_regionsarray | null必須

        ISO country codes where processing may happen; null is unrestricted.

      • exemptionsarray<string>
      • zdr_continuation_storageboolean必須

        Whether zero-retention-routed Responses requests may keep previous_response_id state on the platform (off refuses them with 400 zdr_continuation_disabled).

      • prompt_cachingboolean必須

        False turns prompt caching off across providers.

      • created_bystring | null必須

        User id; null when written with an API key.

      • updated_bystring | null必須

        User id; null when written with an API key.

      • created_atstring必須
      • updated_atstring必須
    • exempt_deployment_idsarray<string>

      Lane ids the stored exemptions cover (display only). Empty on a PUT response.

    • zdr_entitledboolean必須

      Whether this organization may turn require_zdr on (Pro, grandfathered, or already holding it).

  • 400

    A 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.

    レスポンス
    • errorstring必須

      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).

  • 401

    Missing, unknown or revoked API key.

    レスポンス
    • errorstring必須

      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

    needs_subscription: turning on require_zdr or zdr_continuation_storage needs Pro. enterprise_required: authoring a provider allowlist needs the Enterprise capability. An org member below admin also gets 403.

    レスポンス
    • errorstring必須

      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.

    レスポンス
    • errorstring必須

      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

    The account-wide zero-data-retention switch holds both requirements.

    レスポンス
    • errorstring必須

      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 failed validation (unknown field, malformed region or exemption), or allowed_providers was an empty list (send null to allow every provider).

リクエスト

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
}'

レスポンス

{
  "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