shipeasy-sdk 3.8.0 → 4.0.0

data/lib/shipeasy_admin/api/flags_api.rb

@@ -1,7 +1,7 @@
 =begin
-#Shipeasy Admin API
+#Shipeasy Admin API (server-SDK surface)
 
-#REST API for managing feature gates, experiments, configs, universes, and killswitches in a Shipeasy project. Authenticate with an admin SDK key (`Authorization: Bearer sdk_admin_…`) and scope every request to a project via the `X-Project-Id` header.  Mint admin keys via `POST /api/admin/keys` with `type: \"admin\"`. Keys expire after 90 days; rotate with the `revoke` action.
+#The slice of the Shipeasy admin API that the published server SDKs expose as their optional `AdminClient`. Authenticate with an admin SDK key (`Authorization: Bearer sdk_admin_…`) and scope every request to a project via the `X-Project-Id` header.  Three capabilities, nothing else:  - **File a public ticket** — a bug or a feature request onto the project's ops queue. - **Toggle a kill switch** — flip the switch itself, or one of its named sub-switches, on one environment. - **Manage a flag's whitelist** — read, replace, add to, or remove from the allowlist that admits specific identities ahead of every targeting rule.  Everything else in the admin API is reachable through the Shipeasy CLI and MCP server, which speak the complete contract (`openapi.yaml`).
 
 The version of the OpenAPI document: 2.0.0
 
@@ -19,33 +19,47 @@ module Shipeasy::Admin::Generated
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
-    # Create a feature gate
-    # Creates a new gate. Default `enabled: true` at the supplied `rollout_pct` (`0` = fully dark).  Only `name` is required. Request fields use snake_case (`owner_email`); the GET response returns camelCase (`ownerEmail`, `groupName`).  Returns `409` if `name` already exists in the project (case-sensitive).  **Use cases**  - **Dark create + ramp later** — `{ \"name\": \"checkout_v2\" }` at 0% rollout. Ramp via PATCH after deploy validation. - **Targeted rollout** — supply `rules` to gate the caller (e.g. only `plan = pro` users) plus a `rollout_pct` to bucket within that audience. - **Gatekeeper stack** — supply `stack` instead of `rules`/`rollout_pct` for `internal ∪ beta ∪ public` fall-through. Stack entries evaluated top-to-bottom; first match wins. - **Dashboard metadata** — populate `title`, `description`, `folder`, `group`, `owner_email` so the admin UI is self-documenting from day one. - **Disabled on create** — pre-provision with `enabled: false` for a future launch; flip on with `POST /{id}/enable` at go-live.
-    # @param create_gate_request [CreateGateRequest] 
+    # Add entries to a gate's whitelist
+    # Adds identities to the gate's whitelist, creating the block if the gate doesn't have one yet. Entries already on the list are skipped, so the call is idempotent and safe to retry.  Adding to a gate that already has a whitelist keyed on the other attribute is rejected (409) rather than silently re-keying the entries already there — use `PUT` to switch `attr` deliberately.  **Use case:** Let one more customer into a private beta without reading the current list first.
+    # @param id [String] Stable opaque gate id (`gate_…`) or the gate's `name`.
+    # @param add_to_gate_whitelist_request [AddToGateWhitelistRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [CreateGateResponse]
-    def create_gate(create_gate_request, opts = {})
-      data, _status_code, _headers = create_gate_with_http_info(create_gate_request, opts)
+    # @return [GateWhitelist]
+    def add_to_gate_whitelist(id, add_to_gate_whitelist_request, opts = {})
+      data, _status_code, _headers = add_to_gate_whitelist_with_http_info(id, add_to_gate_whitelist_request, opts)
       data
     end
 
-    # Create a feature gate
-    # Creates a new gate. Default `enabled: true` at the supplied `rollout_pct` (`0` = fully dark).  Only `name` is required. Request fields use snake_case (`owner_email`); the GET response returns camelCase (`ownerEmail`, `groupName`).  Returns `409` if `name` already exists in the project (case-sensitive).  **Use cases**  - **Dark create + ramp later** — `{ \"name\": \"checkout_v2\" }` at 0% rollout. Ramp via PATCH after deploy validation. - **Targeted rollout** — supply `rules` to gate the caller (e.g. only `plan = pro` users) plus a `rollout_pct` to bucket within that audience. - **Gatekeeper stack** — supply `stack` instead of `rules`/`rollout_pct` for `internal ∪ beta ∪ public` fall-through. Stack entries evaluated top-to-bottom; first match wins. - **Dashboard metadata** — populate `title`, `description`, `folder`, `group`, `owner_email` so the admin UI is self-documenting from day one. - **Disabled on create** — pre-provision with `enabled: false` for a future launch; flip on with `POST /{id}/enable` at go-live.
-    # @param create_gate_request [CreateGateRequest] 
+    # Add entries to a gate's whitelist
+    # Adds identities to the gate's whitelist, creating the block if the gate doesn't have one yet. Entries already on the list are skipped, so the call is idempotent and safe to retry.  Adding to a gate that already has a whitelist keyed on the other attribute is rejected (409) rather than silently re-keying the entries already there — use `PUT` to switch `attr` deliberately.  **Use case:** Let one more customer into a private beta without reading the current list first.
+    # @param id [String] Stable opaque gate id (`gate_…`) or the gate's `name`.
+    # @param add_to_gate_whitelist_request [AddToGateWhitelistRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [Array<(CreateGateResponse, Integer, Hash)>] CreateGateResponse data, response status code and response headers
-    def create_gate_with_http_info(create_gate_request, opts = {})
+    # @return [Array<(GateWhitelist, Integer, Hash)>] GateWhitelist data, response status code and response headers
+    def add_to_gate_whitelist_with_http_info(id, add_to_gate_whitelist_request, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: FlagsApi.create_gate ...'
+        @api_client.config.logger.debug 'Calling API: FlagsApi.add_to_gate_whitelist ...'
       end
-      # verify the required parameter 'create_gate_request' is set
-      if @api_client.config.client_side_validation && create_gate_request.nil?
-        fail ArgumentError, "Missing the required parameter 'create_gate_request' when calling FlagsApi.create_gate"
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling FlagsApi.add_to_gate_whitelist"
+      end
+      if @api_client.config.client_side_validation && id.to_s.length > 128
+        fail ArgumentError, 'invalid value for "id" when calling FlagsApi.add_to_gate_whitelist, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && id.to_s.length < 1
+        fail ArgumentError, 'invalid value for "id" when calling FlagsApi.add_to_gate_whitelist, the character length must be greater than or equal to 1.'
+      end
+
+      # verify the required parameter 'add_to_gate_whitelist_request' is set
+      if @api_client.config.client_side_validation && add_to_gate_whitelist_request.nil?
+        fail ArgumentError, "Missing the required parameter 'add_to_gate_whitelist_request' when calling FlagsApi.add_to_gate_whitelist"
       end
       # resource path
-      local_var_path = '/api/admin/gates'
+      local_var_path = '/api/admin/gates/{id}/whitelist'.sub('{id}', CGI.escape(id.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -65,16 +79,16 @@ module Shipeasy::Admin::Generated
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(create_gate_request)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(add_to_gate_whitelist_request)
 
       # return_type
-      return_type = opts[:debug_return_type] || 'CreateGateResponse'
+      return_type = opts[:debug_return_type] || 'GateWhitelist'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['bearerSdkKey']
 
       new_options = opts.merge(
-        :operation => :"FlagsApi.create_gate",
+        :operation => :"FlagsApi.add_to_gate_whitelist",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -85,100 +99,46 @@ module Shipeasy::Admin::Generated
 
       data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: FlagsApi#create_gate\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers
-    end
-
-    # Delete a feature gate
-    # Soft-deletes the gate. Returns 409 if the gate is still referenced by a running experiment as a targeting gate — stop the experiment first.  **Use case:** Tear down a gate after a feature has fully shipped and the rollout flag is no longer needed.
-    # @param id [String] Stable opaque gate id (&#x60;gat_…&#x60;) or the gate&#39;s &#x60;name&#x60;.
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [DeleteGateResponse]
-    def delete_gate(id, opts = {})
-      data, _status_code, _headers = delete_gate_with_http_info(id, opts)
-      data
-    end
-
-    # Delete a feature gate
-    # Soft-deletes the gate. Returns 409 if the gate is still referenced by a running experiment as a targeting gate — stop the experiment first.  **Use case:** Tear down a gate after a feature has fully shipped and the rollout flag is no longer needed.
-    # @param id [String] Stable opaque gate id (&#x60;gat_…&#x60;) or the gate&#39;s &#x60;name&#x60;.
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [Array<(DeleteGateResponse, Integer, Hash)>] DeleteGateResponse data, response status code and response headers
-    def delete_gate_with_http_info(id, opts = {})
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: FlagsApi.delete_gate ...'
-      end
-      # resource path
-      local_var_path = '/api/admin/gates/{id}'.sub('{id}', CGI.escape(id.to_s))
-
-      # query parameters
-      query_params = opts[:query_params] || {}
-
-      # header parameters
-      header_params = opts[:header_params] || {}
-      # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
-      header_params[:'X-Project-Id'] = opts[:'x_project_id'] if !opts[:'x_project_id'].nil?
-
-      # form parameters
-      form_params = opts[:form_params] || {}
-
-      # http body (model)
-      post_body = opts[:debug_body]
-
-      # return_type
-      return_type = opts[:debug_return_type] || 'DeleteGateResponse'
-
-      # auth_names
-      auth_names = opts[:debug_auth_names] || ['bearerSdkKey']
-
-      new_options = opts.merge(
-        :operation => :"FlagsApi.delete_gate",
-        :header_params => header_params,
-        :query_params => query_params,
-        :form_params => form_params,
-        :body => post_body,
-        :auth_names => auth_names,
-        :return_type => return_type
-      )
-
-      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
-      if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: FlagsApi#delete_gate\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: FlagsApi#add_to_gate_whitelist\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Disable a gate
-    # Sets `enabled: false` so the gate evaluates to `false` for every caller, regardless of `rollout_pct` or `rules`. Use as a quick kill switch.  **Use case:** Flip a gate off in production without redeploying — the canonical kill-switch flow.
-    # @param id [String] Stable opaque gate id (&#x60;gat_…&#x60;) or the gate&#39;s &#x60;name&#x60;.
+    # Read a gate's whitelist
+    # Returns the gate's whitelist — the always-first allowlist that admits the listed identities before any targeting rule or percentage rollout is evaluated.  A gate with no whitelist returns `entries: []` (and the default `attr`), never a 404 — so a caller can read-then-write without special-casing the empty gate.  **Use case:** Check whether an account is already let through before adding it.
+    # @param id [String] Stable opaque gate id (&#x60;gate_…&#x60;) or the gate&#39;s &#x60;name&#x60;.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [DisableGateResponse]
-    def disable_gate(id, opts = {})
-      data, _status_code, _headers = disable_gate_with_http_info(id, opts)
+    # @return [GateWhitelist]
+    def get_gate_whitelist(id, opts = {})
+      data, _status_code, _headers = get_gate_whitelist_with_http_info(id, opts)
       data
     end
 
-    # Disable a gate
-    # Sets &#x60;enabled: false&#x60; so the gate evaluates to &#x60;false&#x60; for every caller, regardless of &#x60;rollout_pct&#x60; or &#x60;rules&#x60;. Use as a quick kill switch.  **Use case:** Flip a gate off in production without redeploying — the canonical kill-switch flow.
-    # @param id [String] Stable opaque gate id (&#x60;gat_…&#x60;) or the gate&#39;s &#x60;name&#x60;.
+    # Read a gate&#39;s whitelist
+    # Returns the gate&#39;s whitelist — the always-first allowlist that admits the listed identities before any targeting rule or percentage rollout is evaluated.  A gate with no whitelist returns &#x60;entries: []&#x60; (and the default &#x60;attr&#x60;), never a 404 — so a caller can read-then-write without special-casing the empty gate.  **Use case:** Check whether an account is already let through before adding it.
+    # @param id [String] Stable opaque gate id (&#x60;gate_…&#x60;) or the gate&#39;s &#x60;name&#x60;.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [Array<(DisableGateResponse, Integer, Hash)>] DisableGateResponse data, response status code and response headers
-    def disable_gate_with_http_info(id, opts = {})
+    # @return [Array<(GateWhitelist, Integer, Hash)>] GateWhitelist data, response status code and response headers
+    def get_gate_whitelist_with_http_info(id, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: FlagsApi.disable_gate ...'
+        @api_client.config.logger.debug 'Calling API: FlagsApi.get_gate_whitelist ...'
       end
       # verify the required parameter 'id' is set
       if @api_client.config.client_side_validation && id.nil?
-        fail ArgumentError, "Missing the required parameter 'id' when calling FlagsApi.disable_gate"
+        fail ArgumentError, "Missing the required parameter 'id' when calling FlagsApi.get_gate_whitelist"
       end
+      if @api_client.config.client_side_validation && id.to_s.length > 128
+        fail ArgumentError, 'invalid value for "id" when calling FlagsApi.get_gate_whitelist, the character length must be smaller than or equal to 128.'
+      end
+
+      if @api_client.config.client_side_validation && id.to_s.length < 1
+        fail ArgumentError, 'invalid value for "id" when calling FlagsApi.get_gate_whitelist, the character length must be greater than or equal to 1.'
+      end
+
       # resource path
-      local_var_path = '/api/admin/gates/{id}/disable'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/admin/gates/{id}/whitelist'.sub('{id}', CGI.escape(id.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -196,13 +156,13 @@ module Shipeasy::Admin::Generated
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'DisableGateResponse'
+      return_type = opts[:debug_return_type] || 'GateWhitelist'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['bearerSdkKey']
 
       new_options = opts.merge(
-        :operation => :"FlagsApi.disable_gate",
+        :operation => :"FlagsApi.get_gate_whitelist",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -211,138 +171,83 @@ module Shipeasy::Admin::Generated
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: FlagsApi#disable_gate\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: FlagsApi#get_gate_whitelist\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Enable a gate
-    # Sets `enabled: true`. The current `rollout_pct` is preserved.  **Use case:** Re-enable a previously disabled gate without re-issuing a full update.
-    # @param id [String] Stable opaque gate id (&#x60;gat_…&#x60;) or the gate&#39;s &#x60;name&#x60;.
+    # Remove entries from a gate's whitelist
+    # Removes identities from the gate's whitelist. Entries that aren't on the list are skipped, so the call is idempotent.  Removing the last entry leaves an empty whitelist block in place; to drop the block itself use `PUT` with `entries: []`.  **Use case:** Revoke one beta tester's access without touching anyone else's.
+    # @param id [String] Stable opaque gate id (&#x60;gate_…&#x60;) or the gate&#39;s &#x60;name&#x60;.
+    # @param remove_from_gate_whitelist_request [RemoveFromGateWhitelistRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [EnableGateResponse]
-    def enable_gate(id, opts = {})
-      data, _status_code, _headers = enable_gate_with_http_info(id, opts)
+    # @return [GateWhitelist]
+    def remove_from_gate_whitelist(id, remove_from_gate_whitelist_request, opts = {})
+      data, _status_code, _headers = remove_from_gate_whitelist_with_http_info(id, remove_from_gate_whitelist_request, opts)
       data
     end
 
-    # Enable a gate
-    # Sets &#x60;enabled: true&#x60;. The current &#x60;rollout_pct&#x60; is preserved.  **Use case:** Re-enable a previously disabled gate without re-issuing a full update.
-    # @param id [String] Stable opaque gate id (&#x60;gat_…&#x60;) or the gate&#39;s &#x60;name&#x60;.
+    # Remove entries from a gate&#39;s whitelist
+    # Removes identities from the gate&#39;s whitelist. Entries that aren&#39;t on the list are skipped, so the call is idempotent.  Removing the last entry leaves an empty whitelist block in place; to drop the block itself use &#x60;PUT&#x60; with &#x60;entries: []&#x60;.  **Use case:** Revoke one beta tester&#39;s access without touching anyone else&#39;s.
+    # @param id [String] Stable opaque gate id (&#x60;gate_…&#x60;) or the gate&#39;s &#x60;name&#x60;.
+    # @param remove_from_gate_whitelist_request [RemoveFromGateWhitelistRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [Array<(EnableGateResponse, Integer, Hash)>] EnableGateResponse data, response status code and response headers
-    def enable_gate_with_http_info(id, opts = {})
+    # @return [Array<(GateWhitelist, Integer, Hash)>] GateWhitelist data, response status code and response headers
+    def remove_from_gate_whitelist_with_http_info(id, remove_from_gate_whitelist_request, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: FlagsApi.enable_gate ...'
+        @api_client.config.logger.debug 'Calling API: FlagsApi.remove_from_gate_whitelist ...'
       end
       # verify the required parameter 'id' is set
       if @api_client.config.client_side_validation && id.nil?
-        fail ArgumentError, "Missing the required parameter 'id' when calling FlagsApi.enable_gate"
+        fail ArgumentError, "Missing the required parameter 'id' when calling FlagsApi.remove_from_gate_whitelist"
       end
-      # resource path
-      local_var_path = '/api/admin/gates/{id}/enable'.sub('{id}', CGI.escape(id.to_s))
-
-      # query parameters
-      query_params = opts[:query_params] || {}
-
-      # header parameters
-      header_params = opts[:header_params] || {}
-      # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
-      header_params[:'X-Project-Id'] = opts[:'x_project_id'] if !opts[:'x_project_id'].nil?
-
-      # form parameters
-      form_params = opts[:form_params] || {}
-
-      # http body (model)
-      post_body = opts[:debug_body]
-
-      # return_type
-      return_type = opts[:debug_return_type] || 'EnableGateResponse'
-
-      # auth_names
-      auth_names = opts[:debug_auth_names] || ['bearerSdkKey']
-
-      new_options = opts.merge(
-        :operation => :"FlagsApi.enable_gate",
-        :header_params => header_params,
-        :query_params => query_params,
-        :form_params => form_params,
-        :body => post_body,
-        :auth_names => auth_names,
-        :return_type => return_type
-      )
-
-      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
-      if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: FlagsApi#enable_gate\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      if @api_client.config.client_side_validation && id.to_s.length > 128
+        fail ArgumentError, 'invalid value for "id" when calling FlagsApi.remove_from_gate_whitelist, the character length must be smaller than or equal to 128.'
       end
-      return data, status_code, headers
-    end
 
-    # List feature gates
-    # Returns a single page of gates ordered by `updated_at desc, id desc`. Use the `cursor` query parameter to paginate.  **Use case:** Snapshot every gate in the project — for example to render an admin overview or to drive a CI check that asserts no gate is left at 100% in staging.
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @option opts [Integer] :limit Page size (1–500). Defaults to 100. (default to 100)
-    # @option opts [String] :cursor Opaque cursor returned in the previous page&#39;s &#x60;next_cursor&#x60;. Omit for the first page.
-    # @return [ListGatesResponse]
-    def list_gates(opts = {})
-      data, _status_code, _headers = list_gates_with_http_info(opts)
-      data
-    end
-
-    # List feature gates
-    # Returns a single page of gates ordered by &#x60;updated_at desc, id desc&#x60;. Use the &#x60;cursor&#x60; query parameter to paginate.  **Use case:** Snapshot every gate in the project — for example to render an admin overview or to drive a CI check that asserts no gate is left at 100% in staging.
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @option opts [Integer] :limit Page size (1–500). Defaults to 100. (default to 100)
-    # @option opts [String] :cursor Opaque cursor returned in the previous page&#39;s &#x60;next_cursor&#x60;. Omit for the first page.
-    # @return [Array<(ListGatesResponse, Integer, Hash)>] ListGatesResponse data, response status code and response headers
-    def list_gates_with_http_info(opts = {})
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: FlagsApi.list_gates ...'
-      end
-      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 500
-        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling FlagsApi.list_gates, must be smaller than or equal to 500.'
+      if @api_client.config.client_side_validation && id.to_s.length < 1
+        fail ArgumentError, 'invalid value for "id" when calling FlagsApi.remove_from_gate_whitelist, the character length must be greater than or equal to 1.'
       end
 
-      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
-        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling FlagsApi.list_gates, must be greater than or equal to 1.'
+      # verify the required parameter 'remove_from_gate_whitelist_request' is set
+      if @api_client.config.client_side_validation && remove_from_gate_whitelist_request.nil?
+        fail ArgumentError, "Missing the required parameter 'remove_from_gate_whitelist_request' when calling FlagsApi.remove_from_gate_whitelist"
       end
-
       # resource path
-      local_var_path = '/api/admin/gates'
+      local_var_path = '/api/admin/gates/{id}/whitelist'.sub('{id}', CGI.escape(id.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
-      query_params[:'cursor'] = opts[:'cursor'] if !opts[:'cursor'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
       header_params[:'X-Project-Id'] = opts[:'x_project_id'] if !opts[:'x_project_id'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body]
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(remove_from_gate_whitelist_request)
 
       # return_type
-      return_type = opts[:debug_return_type] || 'ListGatesResponse'
+      return_type = opts[:debug_return_type] || 'GateWhitelist'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['bearerSdkKey']
 
       new_options = opts.merge(
-        :operation => :"FlagsApi.list_gates",
+        :operation => :"FlagsApi.remove_from_gate_whitelist",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -351,46 +256,54 @@ module Shipeasy::Admin::Generated
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: FlagsApi#list_gates\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: FlagsApi#remove_from_gate_whitelist\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Update a feature gate
-    # Partial update — only supplied fields change. Array fields (`rules`, `stack`) **replace** wholesale; there is no merge or append.  `name` and the gate id are immutable. The response carries only `{ id }` — re-fetch via `GET /api/admin/gates` for the new row.  **Use cases**  - **Ramp rollout** — `{ \"rollout_pct\": 5000 }` for 50%. Basis points (0–10000); `100` = 1%. - **Kill switch** — `{ \"enabled\": false }`. Forces evaluation to `false` for every caller regardless of rules/rollout. Re-enable with `POST /{id}/enable` or `{ \"enabled\": true }`. - **Modify a rule's `in` set** — send the full new `rules` array. To add `'GB'` to `['US','CA']`: `{ \"rules\": [{ \"attr\": \"country\", \"op\": \"in\", \"value\": [\"US\",\"CA\",\"GB\"] }] }`. No per-rule patch endpoint. - **Add targeting from scratch** — `{ \"rules\": [{ \"attr\": \"email\", \"op\": \"regex\", \"value\": \"@acme\\\\.com$\" }] }`. - **Switch to gatekeeper stack** — send a non-null `stack`. To revert to flat eval, send `{ \"stack\": null }`. - **Update metadata** — any subset of `title`, `description`, `folder`, `group`, `owner_email`.
-    # @param id [String] Stable opaque gate id (&#x60;gat_…&#x60;) or the gate&#39;s &#x60;name&#x60;.
-    # @param update_gate_request [UpdateGateRequest] 
+    # Replace a gate's whitelist
+    # Replaces the gate's whole whitelist with `entries`, creating the block if the gate didn't have one. Idempotent — the same call twice leaves the same list.  This is the only whitelist call that can switch `attr` (`email` ⇄ `user_id`) or clear the block: `entries: []` removes the whitelist from the gate entirely.  **Use cases**  - **Pin an exact list** — `{ \"entries\": [\"alice@acme.dev\", \"bob@acme.dev\"] }`. - **Switch to user ids** — `{ \"attr\": \"user_id\", \"entries\": [\"usr_123\"] }`. - **Drop the whitelist** — `{ \"entries\": [] }`.
+    # @param id [String] Stable opaque gate id (&#x60;gate_…&#x60;) or the gate&#39;s &#x60;name&#x60;.
+    # @param set_gate_whitelist_request [SetGateWhitelistRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [UpdateGateResponse]
-    def update_gate(id, update_gate_request, opts = {})
-      data, _status_code, _headers = update_gate_with_http_info(id, update_gate_request, opts)
+    # @return [GateWhitelist]
+    def set_gate_whitelist(id, set_gate_whitelist_request, opts = {})
+      data, _status_code, _headers = set_gate_whitelist_with_http_info(id, set_gate_whitelist_request, opts)
       data
     end
 
-    # Update a feature gate
-    # Partial update — only supplied fields change. Array fields (&#x60;rules&#x60;, &#x60;stack&#x60;) **replace** wholesale; there is no merge or append.  &#x60;name&#x60; and the gate id are immutable. The response carries only &#x60;{ id }&#x60; — re-fetch via &#x60;GET /api/admin/gates&#x60; for the new row.  **Use cases**  - **Ramp rollout** — &#x60;{ \&quot;rollout_pct\&quot;: 5000 }&#x60; for 50%. Basis points (0–10000); &#x60;100&#x60; &#x3D; 1%. - **Kill switch** — &#x60;{ \&quot;enabled\&quot;: false }&#x60;. Forces evaluation to &#x60;false&#x60; for every caller regardless of rules/rollout. Re-enable with &#x60;POST /{id}/enable&#x60; or &#x60;{ \&quot;enabled\&quot;: true }&#x60;. - **Modify a rule&#39;s &#x60;in&#x60; set** — send the full new &#x60;rules&#x60; array. To add &#x60;&#39;GB&#39;&#x60; to &#x60;[&#39;US&#39;,&#39;CA&#39;]&#x60;: &#x60;{ \&quot;rules\&quot;: [{ \&quot;attr\&quot;: \&quot;country\&quot;, \&quot;op\&quot;: \&quot;in\&quot;, \&quot;value\&quot;: [\&quot;US\&quot;,\&quot;CA\&quot;,\&quot;GB\&quot;] }] }&#x60;. No per-rule patch endpoint. - **Add targeting from scratch** — &#x60;{ \&quot;rules\&quot;: [{ \&quot;attr\&quot;: \&quot;email\&quot;, \&quot;op\&quot;: \&quot;regex\&quot;, \&quot;value\&quot;: \&quot;@acme\\\\.com$\&quot; }] }&#x60;. - **Switch to gatekeeper stack** — send a non-null &#x60;stack&#x60;. To revert to flat eval, send &#x60;{ \&quot;stack\&quot;: null }&#x60;. - **Update metadata** — any subset of &#x60;title&#x60;, &#x60;description&#x60;, &#x60;folder&#x60;, &#x60;group&#x60;, &#x60;owner_email&#x60;.
-    # @param id [String] Stable opaque gate id (&#x60;gat_…&#x60;) or the gate&#39;s &#x60;name&#x60;.
-    # @param update_gate_request [UpdateGateRequest] 
+    # Replace a gate&#39;s whitelist
+    # Replaces the gate&#39;s whole whitelist with &#x60;entries&#x60;, creating the block if the gate didn&#39;t have one. Idempotent — the same call twice leaves the same list.  This is the only whitelist call that can switch &#x60;attr&#x60; (&#x60;email&#x60; ⇄ &#x60;user_id&#x60;) or clear the block: &#x60;entries: []&#x60; removes the whitelist from the gate entirely.  **Use cases**  - **Pin an exact list** — &#x60;{ \&quot;entries\&quot;: [\&quot;alice@acme.dev\&quot;, \&quot;bob@acme.dev\&quot;] }&#x60;. - **Switch to user ids** — &#x60;{ \&quot;attr\&quot;: \&quot;user_id\&quot;, \&quot;entries\&quot;: [\&quot;usr_123\&quot;] }&#x60;. - **Drop the whitelist** — &#x60;{ \&quot;entries\&quot;: [] }&#x60;.
+    # @param id [String] Stable opaque gate id (&#x60;gate_…&#x60;) or the gate&#39;s &#x60;name&#x60;.
+    # @param set_gate_whitelist_request [SetGateWhitelistRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [Array<(UpdateGateResponse, Integer, Hash)>] UpdateGateResponse data, response status code and response headers
-    def update_gate_with_http_info(id, update_gate_request, opts = {})
+    # @return [Array<(GateWhitelist, Integer, Hash)>] GateWhitelist data, response status code and response headers
+    def set_gate_whitelist_with_http_info(id, set_gate_whitelist_request, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: FlagsApi.update_gate ...'
+        @api_client.config.logger.debug 'Calling API: FlagsApi.set_gate_whitelist ...'
       end
       # verify the required parameter 'id' is set
       if @api_client.config.client_side_validation && id.nil?
-        fail ArgumentError, "Missing the required parameter 'id' when calling FlagsApi.update_gate"
+        fail ArgumentError, "Missing the required parameter 'id' when calling FlagsApi.set_gate_whitelist"
+      end
+      if @api_client.config.client_side_validation && id.to_s.length > 128
+        fail ArgumentError, 'invalid value for "id" when calling FlagsApi.set_gate_whitelist, the character length must be smaller than or equal to 128.'
       end
-      # verify the required parameter 'update_gate_request' is set
-      if @api_client.config.client_side_validation && update_gate_request.nil?
-        fail ArgumentError, "Missing the required parameter 'update_gate_request' when calling FlagsApi.update_gate"
+
+      if @api_client.config.client_side_validation && id.to_s.length < 1
+        fail ArgumentError, 'invalid value for "id" when calling FlagsApi.set_gate_whitelist, the character length must be greater than or equal to 1.'
+      end
+
+      # verify the required parameter 'set_gate_whitelist_request' is set
+      if @api_client.config.client_side_validation && set_gate_whitelist_request.nil?
+        fail ArgumentError, "Missing the required parameter 'set_gate_whitelist_request' when calling FlagsApi.set_gate_whitelist"
       end
       # resource path
-      local_var_path = '/api/admin/gates/{id}'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/admin/gates/{id}/whitelist'.sub('{id}', CGI.escape(id.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -410,16 +323,16 @@ module Shipeasy::Admin::Generated
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(update_gate_request)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(set_gate_whitelist_request)
 
       # return_type
-      return_type = opts[:debug_return_type] || 'UpdateGateResponse'
+      return_type = opts[:debug_return_type] || 'GateWhitelist'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['bearerSdkKey']
 
       new_options = opts.merge(
-        :operation => :"FlagsApi.update_gate",
+        :operation => :"FlagsApi.set_gate_whitelist",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -428,9 +341,9 @@ module Shipeasy::Admin::Generated
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(:PUT, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: FlagsApi#update_gate\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: FlagsApi#set_gate_whitelist\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end