fix: address code review issues for dynamic policy tier field

- Add tier and organizationId to UpdateDynamicPolicyRequest
- Add tier and organizationId filters to ListDynamicPoliciesOptions
- Update listDynamicPolicies to pass tier/org_id query params
- Add Javadoc to CreateDynamicPolicyRequest builder methods

Author: saurabhjain1592

CHANGELOG.md

@@ -12,6 +12,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **`tier` field on `CreateDynamicPolicyRequest`**: Allows setting the policy tier (`SYSTEM`, `ORGANIZATION`, `TENANT`) when creating dynamic policies via `.tier(PolicyTier.ORGANIZATION)` builder method. Defaults to `PolicyTier.TENANT` for backward compatibility.
 - **`organizationId` field on `CreateDynamicPolicyRequest`**: Allows specifying the organization ID for organization-tier policies via `.organizationId(String)` builder method. Serialized as `organization_id` in JSON.
 - **`tier` and `organizationId` fields on `DynamicPolicy`**: Response class now includes `getTier()` and `getOrganizationId()` for policy tier metadata.
+- **`tier` and `organizationId` fields on `UpdateDynamicPolicyRequest`**: Allows updating the policy tier and organization ID on existing dynamic policies via `.tier(PolicyTier)` and `.organizationId(String)` builder methods.
+- **`tier` and `organizationId` filters on `ListDynamicPoliciesOptions`**: Allows filtering dynamic policies by tier and organization ID via `.tier(PolicyTier)` and `.organizationId(String)` builder methods, matching `ListStaticPoliciesOptions` parity.
+- **`listDynamicPolicies` query parameters**: `tier` and `organization_id` query parameters are now passed to the API when filtering dynamic policies.
 
 ## [3.1.0] - 2026-02-04
 

src/main/java/com/getaxonflow/sdk/AxonFlow.java

@@ -1877,6 +1877,12 @@ private String buildDynamicPolicyQueryString(String basePath, ListDynamicPolicie
         if (options.getType() != null) {
             appendQueryParam(query, "type", options.getType());
         }
+        if (options.getTier() != null) {
+            appendQueryParam(query, "tier", options.getTier().getValue());
+        }
+        if (options.getOrganizationId() != null) {
+            appendQueryParam(query, "organization_id", options.getOrganizationId());
+        }
         if (options.getEnabled() != null) {
             appendQueryParam(query, "enabled", options.getEnabled().toString());
         }

src/main/java/com/getaxonflow/sdk/types/policies/PolicyTypes.java

@@ -677,6 +677,8 @@ public static class DynamicPolicy {
      */
     public static class ListDynamicPoliciesOptions {
         private String type;  // Filter by policy type: "risk", "content", "user", "cost"
+        private PolicyTier tier;
+        private String organizationId;
         private Boolean enabled;
         private Integer limit;
         private Integer offset;
@@ -689,6 +691,8 @@ public static Builder builder() {
         }
 
         public String getType() { return type; }
+        public PolicyTier getTier() { return tier; }
+        public String getOrganizationId() { return organizationId; }
         public Boolean getEnabled() { return enabled; }
         public Integer getLimit() { return limit; }
         public Integer getOffset() { return offset; }
@@ -710,6 +714,28 @@ public Builder type(String type) {
                 return this;
             }
 
+            /**
+             * Filters policies by tier.
+             *
+             * @param tier the policy tier
+             * @return this builder
+             */
+            public Builder tier(PolicyTier tier) {
+                options.tier = tier;
+                return this;
+            }
+
+            /**
+             * Filters policies by organization ID (Enterprise).
+             *
+             * @param organizationId the organization ID
+             * @return this builder
+             */
+            public Builder organizationId(String organizationId) {
+                options.organizationId = organizationId;
+                return this;
+            }
+
             public Builder enabled(Boolean enabled) {
                 options.enabled = enabled;
                 return this;
@@ -820,11 +846,23 @@ public Builder category(String category) {
                 return this;
             }
 
+            /**
+             * Sets the policy tier. Defaults to {@link PolicyTier#TENANT}.
+             *
+             * @param tier the policy tier
+             * @return this builder
+             */
             public Builder tier(PolicyTier tier) {
                 request.tier = tier;
                 return this;
             }
 
+            /**
+             * Sets the organization ID for organization-tier policies (Enterprise).
+             *
+             * @param organizationId the organization ID
+             * @return this builder
+             */
             public Builder organizationId(String organizationId) {
                 request.organizationId = organizationId;
                 return this;
@@ -871,6 +909,9 @@ public static class UpdateDynamicPolicyRequest {
         private String description;
         private String type;
         private String category;
+        private PolicyTier tier;
+        @JsonProperty("organization_id")
+        private String organizationId;
         private List<DynamicPolicyCondition> conditions;
         private List<DynamicPolicyAction> actions;
         private Integer priority;
@@ -884,6 +925,8 @@ public static Builder builder() {
         public String getDescription() { return description; }
         public String getType() { return type; }
         public String getCategory() { return category; }
+        public PolicyTier getTier() { return tier; }
+        public String getOrganizationId() { return organizationId; }
         public List<DynamicPolicyCondition> getConditions() { return conditions; }
         public List<DynamicPolicyAction> getActions() { return actions; }
         public Integer getPriority() { return priority; }
@@ -918,6 +961,28 @@ public Builder category(String category) {
                 return this;
             }
 
+            /**
+             * Sets the policy tier.
+             *
+             * @param tier the policy tier
+             * @return this builder
+             */
+            public Builder tier(PolicyTier tier) {
+                request.tier = tier;
+                return this;
+            }
+
+            /**
+             * Sets the organization ID for organization-tier policies (Enterprise).
+             *
+             * @param organizationId the organization ID
+             * @return this builder
+             */
+            public Builder organizationId(String organizationId) {
+                request.organizationId = organizationId;
+                return this;
+            }
+
             public Builder conditions(List<DynamicPolicyCondition> conditions) {
                 request.conditions = conditions;
                 return this;