shipeasy-sdk 3.7.0 → 4.0.0

data/lib/shipeasy_admin/models/{delete_alert_rule_response.rb → set_gate_whitelist_request.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
 
@@ -14,8 +14,13 @@ require 'date'
 require 'time'
 
 module Shipeasy::Admin::Generated
-  class DeleteAlertRuleResponse < ApiModelBase
-    attr_accessor :ok
+  # Body for `PUT /api/admin/gates/{id}/whitelist`. Replaces the whole list — idempotent, and the only call that can switch `attr` or clear the whitelist.
+  class SetGateWhitelistRequest < ApiModelBase
+    # Identity attribute to match on. Defaults to the whitelist's current attribute, or `email` when the gate has no whitelist yet.
+    attr_accessor :attr
+
+    # The complete whitelist after the call. Pass `[]` to remove the whitelist from the gate entirely.
+    attr_accessor :entries
 
     class EnumAttributeValidator
       attr_reader :datatype
@@ -42,7 +47,8 @@ module Shipeasy::Admin::Generated
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'ok' => :'ok'
+        :'attr' => :'attr',
+        :'entries' => :'entries'
       }
     end
 
@@ -59,7 +65,8 @@ module Shipeasy::Admin::Generated
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'ok' => :'Boolean'
+        :'attr' => :'GateWhitelistAttr',
+        :'entries' => :'Array<String>'
       }
     end
 
@@ -73,22 +80,28 @@ module Shipeasy::Admin::Generated
     # @param [Hash] attributes Model attributes in the form of hash
     def initialize(attributes = {})
       if (!attributes.is_a?(Hash))
-        fail ArgumentError, "The input argument (attributes) must be a hash in `Shipeasy::Admin::Generated::DeleteAlertRuleResponse` initialize method"
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Shipeasy::Admin::Generated::SetGateWhitelistRequest` initialize method"
       end
 
       # check to see if the attribute exists and convert string to symbol for hash key
       acceptable_attribute_map = self.class.acceptable_attribute_map
       attributes = attributes.each_with_object({}) { |(k, v), h|
         if (!acceptable_attribute_map.key?(k.to_sym))
-          fail ArgumentError, "`#{k}` is not a valid attribute in `Shipeasy::Admin::Generated::DeleteAlertRuleResponse`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Shipeasy::Admin::Generated::SetGateWhitelistRequest`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
         end
         h[k.to_sym] = v
       }
 
-      if attributes.key?(:'ok')
-        self.ok = attributes[:'ok']
+      if attributes.key?(:'attr')
+        self.attr = attributes[:'attr']
+      end
+
+      if attributes.key?(:'entries')
+        if (value = attributes[:'entries']).is_a?(Array)
+          self.entries = value
+        end
       else
-        self.ok = nil
+        self.entries = nil
       end
     end
 
@@ -97,8 +110,8 @@ module Shipeasy::Admin::Generated
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
-      if @ok.nil?
-        invalid_properties.push('invalid value for "ok", ok cannot be nil.')
+      if @entries.nil?
+        invalid_properties.push('invalid value for "entries", entries cannot be nil.')
       end
 
       invalid_properties
@@ -108,20 +121,18 @@ module Shipeasy::Admin::Generated
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
-      return false if @ok.nil?
-      ok_validator = EnumAttributeValidator.new('Boolean', ["true"])
-      return false unless ok_validator.valid?(@ok)
+      return false if @entries.nil?
       true
     end
 
-    # Custom attribute writer method checking allowed values (enum).
-    # @param [Object] ok Object to be assigned
-    def ok=(ok)
-      validator = EnumAttributeValidator.new('Boolean', ["true"])
-      unless validator.valid?(ok)
-        fail ArgumentError, "invalid value for \"ok\", must be one of #{validator.allowable_values}."
+    # Custom attribute writer method with validation
+    # @param [Object] entries Value to be assigned
+    def entries=(entries)
+      if entries.nil?
+        fail ArgumentError, 'entries cannot be nil'
       end
-      @ok = ok
+
+      @entries = entries
     end
 
     # Checks equality by comparing each attribute.
@@ -129,7 +140,8 @@ module Shipeasy::Admin::Generated
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
-          ok == o.ok
+          attr == o.attr &&
+          entries == o.entries
     end
 
     # @see the `==` method
@@ -141,7 +153,7 @@ module Shipeasy::Admin::Generated
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [ok].hash
+      [attr, entries].hash
     end
 
     # Builds the object from hash

data/lib/shipeasy_admin/models/{set_killswitch_switch_request.rb → toggle_killswitch_request.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
 
@@ -14,16 +14,17 @@ require 'date'
 require 'time'
 
 module Shipeasy::Admin::Generated
-  # Body for `PUT /api/admin/killswitches/{id}/switch`. Sets or updates one switch entry on one env.
-  class SetKillswitchSwitchRequest < ApiModelBase
-    attr_accessor :env
-
-    # Switch key to set.
+  # Body for `POST /api/admin/killswitches/{id}/toggle`. Every field is optional, so the four useful calls read as one method with a widening argument list:  - `{}` — flip the flat value on prod. - `{ \"switchKey\": \"eu_region\" }` — flip that sub-switch on prod. - `{ \"switchKey\": \"eu_region\", \"value\": true }` — set that sub-switch on prod, idempotently. - `{ \"switchKey\": \"eu_region\", \"value\": true, \"env\": \"staging\" }` — the same, on a chosen env.
+  class ToggleKillswitchRequest < ApiModelBase
+    # Which target to flip. Omit (or `null`) to flip the killswitch's own flat `value`; name a switch key to flip that nested sub-switch instead, creating the entry if it doesn't exist yet.
     attr_accessor :switch_key
 
-    # New boolean value for this `switchKey` on this `env`.
+    # The value to publish. Omit (or `null`) to flip whatever is stored now — read-modify-write in one call. Pass an explicit `true`/`false` to make the call idempotent, so a retry can't undo the first attempt.
     attr_accessor :value
 
+    # Environment to publish on. Defaults to `prod` — the environment an incident response means when it says \"kill it\".
+    attr_accessor :env
+
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -49,9 +50,9 @@ module Shipeasy::Admin::Generated
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'env' => :'env',
         :'switch_key' => :'switchKey',
-        :'value' => :'value'
+        :'value' => :'value',
+        :'env' => :'env'
       }
     end
 
@@ -68,15 +69,17 @@ module Shipeasy::Admin::Generated
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'env' => :'Env',
         :'switch_key' => :'String',
-        :'value' => :'Boolean'
+        :'value' => :'Boolean',
+        :'env' => :'Env'
       }
     end
 
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
+        :'switch_key',
+        :'value',
       ])
     end
 
@@ -84,34 +87,28 @@ module Shipeasy::Admin::Generated
     # @param [Hash] attributes Model attributes in the form of hash
     def initialize(attributes = {})
       if (!attributes.is_a?(Hash))
-        fail ArgumentError, "The input argument (attributes) must be a hash in `Shipeasy::Admin::Generated::SetKillswitchSwitchRequest` initialize method"
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Shipeasy::Admin::Generated::ToggleKillswitchRequest` initialize method"
       end
 
       # check to see if the attribute exists and convert string to symbol for hash key
       acceptable_attribute_map = self.class.acceptable_attribute_map
       attributes = attributes.each_with_object({}) { |(k, v), h|
         if (!acceptable_attribute_map.key?(k.to_sym))
-          fail ArgumentError, "`#{k}` is not a valid attribute in `Shipeasy::Admin::Generated::SetKillswitchSwitchRequest`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Shipeasy::Admin::Generated::ToggleKillswitchRequest`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
         end
         h[k.to_sym] = v
       }
 
-      if attributes.key?(:'env')
-        self.env = attributes[:'env']
-      else
-        self.env = nil
-      end
-
       if attributes.key?(:'switch_key')
         self.switch_key = attributes[:'switch_key']
-      else
-        self.switch_key = nil
       end
 
       if attributes.key?(:'value')
         self.value = attributes[:'value']
-      else
-        self.value = nil
+      end
+
+      if attributes.key?(:'env')
+        self.env = attributes[:'env']
       end
     end
 
@@ -120,27 +117,15 @@ module Shipeasy::Admin::Generated
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
-      if @env.nil?
-        invalid_properties.push('invalid value for "env", env cannot be nil.')
-      end
-
-      if @switch_key.nil?
-        invalid_properties.push('invalid value for "switch_key", switch_key cannot be nil.')
-      end
-
-      if @switch_key.to_s.length > 64
+      if !@switch_key.nil? && @switch_key.to_s.length > 64
         invalid_properties.push('invalid value for "switch_key", the character length must be smaller than or equal to 64.')
       end
 
       pattern = Regexp.new(/^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$/)
-      if @switch_key !~ pattern
+      if !@switch_key.nil? && @switch_key !~ pattern
         invalid_properties.push("invalid value for \"switch_key\", must conform to the pattern #{pattern}.")
       end
 
-      if @value.nil?
-        invalid_properties.push('invalid value for "value", value cannot be nil.')
-      end
-
       invalid_properties
     end
 
@@ -148,61 +133,34 @@ module Shipeasy::Admin::Generated
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
-      return false if @env.nil?
-      return false if @switch_key.nil?
-      return false if @switch_key.to_s.length > 64
-      return false if @switch_key !~ Regexp.new(/^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$/)
-      return false if @value.nil?
+      return false if !@switch_key.nil? && @switch_key.to_s.length > 64
+      return false if !@switch_key.nil? && @switch_key !~ Regexp.new(/^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$/)
       true
     end
 
-    # Custom attribute writer method with validation
-    # @param [Object] env Value to be assigned
-    def env=(env)
-      if env.nil?
-        fail ArgumentError, 'env cannot be nil'
-      end
-
-      @env = env
-    end
-
     # Custom attribute writer method with validation
     # @param [Object] switch_key Value to be assigned
     def switch_key=(switch_key)
-      if switch_key.nil?
-        fail ArgumentError, 'switch_key cannot be nil'
-      end
-
-      if switch_key.to_s.length > 64
+      if !switch_key.nil? && switch_key.to_s.length > 64
         fail ArgumentError, 'invalid value for "switch_key", the character length must be smaller than or equal to 64.'
       end
 
       pattern = Regexp.new(/^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$/)
-      if switch_key !~ pattern
+      if !switch_key.nil? && switch_key !~ pattern
         fail ArgumentError, "invalid value for \"switch_key\", must conform to the pattern #{pattern}."
       end
 
       @switch_key = switch_key
     end
 
-    # Custom attribute writer method with validation
-    # @param [Object] value Value to be assigned
-    def value=(value)
-      if value.nil?
-        fail ArgumentError, 'value cannot be nil'
-      end
-
-      @value = value
-    end
-
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
-          env == o.env &&
           switch_key == o.switch_key &&
-          value == o.value
+          value == o.value &&
+          env == o.env
     end
 
     # @see the `==` method
@@ -214,7 +172,7 @@ module Shipeasy::Admin::Generated
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [env, switch_key, value].hash
+      [switch_key, value, env].hash
     end
 
     # Builds the object from hash

data/lib/shipeasy_admin/models/{set_killswitch_value_response.rb → toggle_killswitch_response.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
 
@@ -14,11 +14,21 @@ require 'date'
 require 'time'
 
 module Shipeasy::Admin::Generated
-  class SetKillswitchValueResponse < ApiModelBase
+  class ToggleKillswitchResponse < ApiModelBase
+    # Resolved killswitch id.
     attr_accessor :id
 
     attr_accessor :env
 
+    # The sub-switch that was flipped, or `null` when the flat `value` was.
+    attr_accessor :switch_key
+
+    # The value that was in effect before this call. Equal to `value` when an idempotent `value` matched what was already stored.
+    attr_accessor :previous
+
+    # The value now in effect on `env`.
+    attr_accessor :value
+
     # Newly published version on `env`.
     attr_accessor :version
 
@@ -51,6 +61,9 @@ module Shipeasy::Admin::Generated
       {
         :'id' => :'id',
         :'env' => :'env',
+        :'switch_key' => :'switchKey',
+        :'previous' => :'previous',
+        :'value' => :'value',
         :'version' => :'version',
         :'published' => :'published'
       }
@@ -71,6 +84,9 @@ module Shipeasy::Admin::Generated
       {
         :'id' => :'String',
         :'env' => :'Env',
+        :'switch_key' => :'String',
+        :'previous' => :'Boolean',
+        :'value' => :'Boolean',
         :'version' => :'Integer',
         :'published' => :'KillswitchValue'
       }
@@ -79,6 +95,7 @@ module Shipeasy::Admin::Generated
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
+        :'switch_key',
       ])
     end
 
@@ -86,14 +103,14 @@ module Shipeasy::Admin::Generated
     # @param [Hash] attributes Model attributes in the form of hash
     def initialize(attributes = {})
       if (!attributes.is_a?(Hash))
-        fail ArgumentError, "The input argument (attributes) must be a hash in `Shipeasy::Admin::Generated::SetKillswitchValueResponse` initialize method"
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Shipeasy::Admin::Generated::ToggleKillswitchResponse` initialize method"
       end
 
       # check to see if the attribute exists and convert string to symbol for hash key
       acceptable_attribute_map = self.class.acceptable_attribute_map
       attributes = attributes.each_with_object({}) { |(k, v), h|
         if (!acceptable_attribute_map.key?(k.to_sym))
-          fail ArgumentError, "`#{k}` is not a valid attribute in `Shipeasy::Admin::Generated::SetKillswitchValueResponse`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Shipeasy::Admin::Generated::ToggleKillswitchResponse`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
         end
         h[k.to_sym] = v
       }
@@ -110,6 +127,24 @@ module Shipeasy::Admin::Generated
         self.env = nil
       end
 
+      if attributes.key?(:'switch_key')
+        self.switch_key = attributes[:'switch_key']
+      else
+        self.switch_key = nil
+      end
+
+      if attributes.key?(:'previous')
+        self.previous = attributes[:'previous']
+      else
+        self.previous = nil
+      end
+
+      if attributes.key?(:'value')
+        self.value = attributes[:'value']
+      else
+        self.value = nil
+      end
+
       if attributes.key?(:'version')
         self.version = attributes[:'version']
       else
@@ -136,6 +171,23 @@ module Shipeasy::Admin::Generated
         invalid_properties.push('invalid value for "env", env cannot be nil.')
       end
 
+      if @switch_key.to_s.length > 64
+        invalid_properties.push('invalid value for "switch_key", the character length must be smaller than or equal to 64.')
+      end
+
+      pattern = Regexp.new(/^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$/)
+      if @switch_key !~ pattern
+        invalid_properties.push("invalid value for \"switch_key\", must conform to the pattern #{pattern}.")
+      end
+
+      if @previous.nil?
+        invalid_properties.push('invalid value for "previous", previous cannot be nil.')
+      end
+
+      if @value.nil?
+        invalid_properties.push('invalid value for "value", value cannot be nil.')
+      end
+
       if @version.nil?
         invalid_properties.push('invalid value for "version", version cannot be nil.')
       end
@@ -161,6 +213,10 @@ module Shipeasy::Admin::Generated
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @id.nil?
       return false if @env.nil?
+      return false if @switch_key.to_s.length > 64
+      return false if @switch_key !~ Regexp.new(/^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$/)
+      return false if @previous.nil?
+      return false if @value.nil?
       return false if @version.nil?
       return false if @version > 9007199254740991
       return false if @version < -9007199254740991
@@ -188,6 +244,41 @@ module Shipeasy::Admin::Generated
       @env = env
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] switch_key Value to be assigned
+    def switch_key=(switch_key)
+      if !switch_key.nil? && switch_key.to_s.length > 64
+        fail ArgumentError, 'invalid value for "switch_key", the character length must be smaller than or equal to 64.'
+      end
+
+      pattern = Regexp.new(/^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$/)
+      if !switch_key.nil? && switch_key !~ pattern
+        fail ArgumentError, "invalid value for \"switch_key\", must conform to the pattern #{pattern}."
+      end
+
+      @switch_key = switch_key
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] previous Value to be assigned
+    def previous=(previous)
+      if previous.nil?
+        fail ArgumentError, 'previous cannot be nil'
+      end
+
+      @previous = previous
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] value Value to be assigned
+    def value=(value)
+      if value.nil?
+        fail ArgumentError, 'value cannot be nil'
+      end
+
+      @value = value
+    end
+
     # Custom attribute writer method with validation
     # @param [Object] version Value to be assigned
     def version=(version)
@@ -223,6 +314,9 @@ module Shipeasy::Admin::Generated
       self.class == o.class &&
           id == o.id &&
           env == o.env &&
+          switch_key == o.switch_key &&
+          previous == o.previous &&
+          value == o.value &&
           version == o.version &&
           published == o.published
     end
@@ -236,7 +330,7 @@ module Shipeasy::Admin::Generated
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, env, version, published].hash
+      [id, env, switch_key, previous, value, version, published].hash
     end
 
     # Builds the object from hash

data/lib/shipeasy_admin/version.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