coss 0.1.0 → 0.2.0

data/lib/coss/inboxes/client.rb

@@ -0,0 +1,234 @@
+# frozen_string_literal: true
+
+module Coss
+  module Inboxes
+    class Client
+      # @param client [Coss::Internal::Http::RawClient]
+      #
+      # @return [void]
+      def initialize(client:)
+        @client = client
+      end
+
+      # The environment's inboxes, newest first. Pass the last `id` as `after` to get the next page while `has_more` is
+      # true.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [Integer, nil] :limit
+      # @option params [String, nil] :after
+      #
+      # @example
+      #   client.inboxes.list
+      #
+      # @return [Coss::Types::InboxList]
+      def list(request_options: {}, **params)
+        params = Coss::Internal::Types::Utils.normalize_keys(params)
+        query_params = {}
+        query_params["limit"] = params[:limit] if params.key?(:limit)
+        query_params["after"] = params[:after] if params.key?(:after)
+
+        request = Coss::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "v1/inboxes",
+          query: query_params,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Coss::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          (response.body.to_s.empty? ? nil : Coss::Types::InboxList.load(response.body))
+        else
+          error_class = Coss::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Gives an agent (or anyone) its own email address in the API key's environment: `username@<the environment's
+      # inbound domain>`, which needs no DNS setup, or an address at one of the environment's receiving domains
+      # (`domain`). Mail to it is kept as threads, and each message that arrives sends an `inbox.message.received`
+      # webhook. With a `client_id` that already has an inbox, that inbox is returned (200) instead of a new one.
+      #
+      # @param request_options [Hash]
+      # @param params [Coss::Inboxes::Types::CreateInboxRequest]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      #
+      # @example
+      #   client.inboxes.create(
+      #     username: "support-agent",
+      #     display_name: "Acme Support",
+      #     client_id: "agent-42"
+      #   )
+      #
+      # @return [Coss::Types::Inbox]
+      def create(request_options: {}, **params)
+        params = Coss::Internal::Types::Utils.normalize_keys(params)
+        headers = { "Idempotency-Key" => Coss::Internal::IdempotencyKey.generate }
+        request = Coss::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "v1/inboxes",
+          headers: headers,
+          body: Coss::Inboxes::Types::CreateInboxRequest.new(params).to_h,
+          request_options: request_options,
+          max_retries: 0
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Coss::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          (response.body.to_s.empty? ? nil : Coss::Types::Inbox.load(response.body))
+        else
+          error_class = Coss::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :inbox_id
+      #
+      # @example
+      #   client.inboxes.get(inbox_id: "inbox_01k7c8m4q2f3e9v6t5r1n0p8yz")
+      #
+      # @return [Coss::Types::Inbox]
+      def get(request_options: {}, **params)
+        params = Coss::Internal::Types::Utils.normalize_keys(params)
+        request = Coss::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "v1/inboxes/#{URI.encode_uri_component(params[:inbox_id].to_s)}",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Coss::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          (response.body.to_s.empty? ? nil : Coss::Types::Inbox.load(response.body))
+        else
+          error_class = Coss::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Deletes the inbox and its threads. The received emails and emails they held stay in the environment until their
+      # retention ends, and mail to the address is still received by the environment (without a thread or
+      # `inbox.message.received` webhook).
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :inbox_id
+      #
+      # @example
+      #   client.inboxes.delete(inbox_id: "inbox_01k7c8m4q2f3e9v6t5r1n0p8yz")
+      #
+      # @return [Coss::Types::DeletedInbox]
+      def delete(request_options: {}, **params)
+        params = Coss::Internal::Types::Utils.normalize_keys(params)
+        request = Coss::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "DELETE",
+          path: "v1/inboxes/#{URI.encode_uri_component(params[:inbox_id].to_s)}",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Coss::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          (response.body.to_s.empty? ? nil : Coss::Types::DeletedInbox.load(response.body))
+        else
+          error_class = Coss::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Changes the name messages from the inbox are sent with. Its address never changes.
+      #
+      # @param request_options [Hash]
+      # @param params [Coss::Inboxes::Types::UpdateInboxRequest]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :inbox_id
+      #
+      # @example
+      #   client.inboxes.update(
+      #     inbox_id: "inbox_01k7c8m4q2f3e9v6t5r1n0p8yz",
+      #     display_name: "Acme Help"
+      #   )
+      #
+      # @return [Coss::Types::Inbox]
+      def update(request_options: {}, **params)
+        params = Coss::Internal::Types::Utils.normalize_keys(params)
+        request_data = Coss::Inboxes::Types::UpdateInboxRequest.new(params).to_h
+        non_body_param_names = %w[inbox_id]
+        body = request_data.except(*non_body_param_names)
+
+        request = Coss::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "PATCH",
+          path: "v1/inboxes/#{URI.encode_uri_component(params[:inbox_id].to_s)}",
+          body: body,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Coss::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          (response.body.to_s.empty? ? nil : Coss::Types::Inbox.load(response.body))
+        else
+          error_class = Coss::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # @return [Coss::Threads::Client]
+      def threads
+        @threads ||= Coss::Inboxes::Threads::Client.new(client: @client)
+      end
+
+      # @return [Coss::Messages::Client]
+      def messages
+        @messages ||= Coss::Inboxes::Messages::Client.new(client: @client)
+      end
+    end
+  end
+end

data/lib/coss/inboxes/messages/client.rb

@@ -0,0 +1,259 @@
+# frozen_string_literal: true
+
+module Coss
+  module Inboxes
+    module Messages
+      class Client
+        # @param client [Coss::Internal::Http::RawClient]
+        #
+        # @return [void]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Messages of every thread, newest first, with a preview instead of their bodies (retrieve one for those). Pass
+        # the last `id` as `after` to get the next page while `has_more` is true.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :inbox_id
+        # @option params [Integer, nil] :limit
+        # @option params [String, nil] :after
+        # @option params [Coss::Inboxes::Messages::Types::ListMessagesRequestDirection, nil] :direction
+        #
+        # @example
+        #   client.inboxes.messages.list(inbox_id: "inbox_01k7c8m4q2f3e9v6t5r1n0p8yz")
+        #
+        # @return [Coss::Types::InboxMessageList]
+        def list(request_options: {}, **params)
+          params = Coss::Internal::Types::Utils.normalize_keys(params)
+          query_params = {}
+          query_params["limit"] = params[:limit] if params.key?(:limit)
+          query_params["after"] = params[:after] if params.key?(:after)
+          query_params["direction"] = params[:direction] if params.key?(:direction)
+
+          request = Coss::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "GET",
+            path: "v1/inboxes/#{URI.encode_uri_component(params[:inbox_id].to_s)}/messages",
+            query: query_params,
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Coss::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            (response.body.to_s.empty? ? nil : Coss::Types::InboxMessageList.load(response.body))
+          else
+            error_class = Coss::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # Starts a thread with a message from the inbox's address, sent like any email (its `email_id` has its delivery
+        # events and webhooks; never tracked). Replies to it arrive in the same thread. Live inboxes send only from
+        # receiving domains under one of the organization's verified domains (`can_send`); sandbox ones always can, and
+        # deliver nothing. Recipients count against the send quota.
+        #
+        # @param request_options [Hash]
+        # @param params [Coss::Inboxes::Messages::Types::SendInboxMessageRequest]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :inbox_id
+        # @option params [String, nil] :idempotency_key
+        #
+        # @example
+        #   client.inboxes.messages.send_(
+        #     inbox_id: "inbox_01k7c8m4q2f3e9v6t5r1n0p8yz",
+        #     idempotency_key: "welcome-user-123",
+        #     to: "jane@example.com",
+        #     subject: "Your order",
+        #     text: "Hi Jane, your order has shipped."
+        #   )
+        #
+        # @return [Coss::Types::InboxMessage]
+        def send_(request_options: {}, **params)
+          params = Coss::Internal::Types::Utils.normalize_keys(params)
+          request_data = Coss::Inboxes::Messages::Types::SendInboxMessageRequest.new(params).to_h
+          non_body_param_names = %w[inbox_id Idempotency-Key]
+          body = request_data.except(*non_body_param_names)
+
+          headers = {}
+          headers["Idempotency-Key"] = params[:idempotency_key] if params[:idempotency_key]
+
+          request = Coss::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "POST",
+            path: "v1/inboxes/#{URI.encode_uri_component(params[:inbox_id].to_s)}/messages",
+            headers: headers,
+            body: body,
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Coss::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            (response.body.to_s.empty? ? nil : Coss::Types::InboxMessage.load(response.body))
+          else
+            error_class = Coss::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # The message with its text, HTML and `extracted_text`. An outbound message's delivery is its email's
+        # (`email_id`).
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :inbox_id
+        # @option params [String] :message_id
+        #
+        # @example
+        #   client.inboxes.messages.get(
+        #     inbox_id: "inbox_01k7c8m4q2f3e9v6t5r1n0p8yz",
+        #     message_id: "imsg_01k7c8m4s1d3c9x0z4e6g7h8j9"
+        #   )
+        #
+        # @return [Coss::Types::InboxMessage]
+        def get(request_options: {}, **params)
+          params = Coss::Internal::Types::Utils.normalize_keys(params)
+          request = Coss::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "GET",
+            path: "v1/inboxes/#{URI.encode_uri_component(params[:inbox_id].to_s)}/messages/#{URI.encode_uri_component(params[:message_id].to_s)}",
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Coss::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            (response.body.to_s.empty? ? nil : Coss::Types::InboxMessage.load(response.body))
+          else
+            error_class = Coss::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # An inbound message's attachment, always as `application/octet-stream` (its declared type is the attachment's
+        # `content_type`): treat it as untrusted.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :inbox_id
+        # @option params [String] :message_id
+        # @option params [String] :attachment_id
+        #
+        # @example
+        #   client.inboxes.messages.get_attachment(
+        #     inbox_id: "inbox_id",
+        #     message_id: "message_id",
+        #     attachment_id: "attachment_id"
+        #   )
+        #
+        # @return [untyped]
+        def get_attachment(request_options: {}, **params)
+          params = Coss::Internal::Types::Utils.normalize_keys(params)
+          request = Coss::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "GET",
+            path: "v1/inboxes/#{URI.encode_uri_component(params[:inbox_id].to_s)}/messages/#{URI.encode_uri_component(params[:message_id].to_s)}/attachments/#{URI.encode_uri_component(params[:attachment_id].to_s)}",
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Coss::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          return response.body if code.between?(200, 299)
+
+          error_class = Coss::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+
+        # Replies in the message's thread from the inbox's address: to its sender (its `Reply-To` first), or to an
+        # outbound message's recipients again for a follow-up; `reply_all` adds everyone else on it. The subject gets
+        # `Re:`, and `In-Reply-To`/`References` let the recipient's mail client thread it. Sent like any email, counted
+        # against the send quota.
+        #
+        # @param request_options [Hash]
+        # @param params [Coss::Inboxes::Messages::Types::ReplyInboxMessageRequest]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :inbox_id
+        # @option params [String] :message_id
+        # @option params [String, nil] :idempotency_key
+        #
+        # @example
+        #   client.inboxes.messages.reply(
+        #     inbox_id: "inbox_01k7c8m4q2f3e9v6t5r1n0p8yz",
+        #     message_id: "imsg_01k7c8m4s1d3c9x0z4e6g7h8j9",
+        #     idempotency_key: "welcome-user-123",
+        #     text: "Sorry about that, Jane! A new one is on its way."
+        #   )
+        #
+        # @return [Coss::Types::InboxMessage]
+        def reply(request_options: {}, **params)
+          params = Coss::Internal::Types::Utils.normalize_keys(params)
+          request_data = Coss::Inboxes::Messages::Types::ReplyInboxMessageRequest.new(params).to_h
+          non_body_param_names = %w[inbox_id message_id Idempotency-Key]
+          body = request_data.except(*non_body_param_names)
+
+          headers = {}
+          headers["Idempotency-Key"] = params[:idempotency_key] if params[:idempotency_key]
+
+          request = Coss::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "POST",
+            path: "v1/inboxes/#{URI.encode_uri_component(params[:inbox_id].to_s)}/messages/#{URI.encode_uri_component(params[:message_id].to_s)}/reply",
+            headers: headers,
+            body: body,
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Coss::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            (response.body.to_s.empty? ? nil : Coss::Types::InboxMessage.load(response.body))
+          else
+            error_class = Coss::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/coss/inboxes/messages/types/get_attachment_messages_request.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Coss
+  module Inboxes
+    module Messages
+      module Types
+        class GetAttachmentMessagesRequest < Internal::Types::Model
+          field :inbox_id, -> { String }, optional: false, nullable: false
+
+          field :message_id, -> { String }, optional: false, nullable: false
+
+          field :attachment_id, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/coss/inboxes/messages/types/get_messages_request.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Coss
+  module Inboxes
+    module Messages
+      module Types
+        class GetMessagesRequest < Internal::Types::Model
+          field :inbox_id, -> { String }, optional: false, nullable: false
+
+          field :message_id, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/coss/inboxes/messages/types/list_messages_request.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Coss
+  module Inboxes
+    module Messages
+      module Types
+        class ListMessagesRequest < Internal::Types::Model
+          field :inbox_id, -> { String }, optional: false, nullable: false
+
+          field :limit, -> { Integer }, optional: true, nullable: false
+
+          field :after, -> { String }, optional: true, nullable: false
+
+          field :direction, -> { Coss::Inboxes::Messages::Types::ListMessagesRequestDirection }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/coss/inboxes/messages/types/list_messages_request_direction.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Coss
+  module Inboxes
+    module Messages
+      module Types
+        module ListMessagesRequestDirection
+          extend Coss::Internal::Types::Enum
+
+          INBOUND = "inbound"
+          OUTBOUND = "outbound"
+        end
+      end
+    end
+  end
+end

data/lib/coss/inboxes/messages/types/reply_inbox_message_request.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Coss
+  module Inboxes
+    module Messages
+      module Types
+        class ReplyInboxMessageRequest < Internal::Types::Model
+          field :inbox_id, -> { String }, optional: false, nullable: false
+
+          field :message_id, -> { String }, optional: false, nullable: false
+
+          field :idempotency_key, -> { String }, optional: true, nullable: false, api_name: "Idempotency-Key"
+
+          field :reply_all, -> { Internal::Types::Boolean }, optional: true, nullable: false
+
+          field :cc, -> { Coss::Inboxes::Messages::Types::ReplyInboxMessageRequestCc }, optional: true, nullable: false
+
+          field :bcc, -> { Coss::Inboxes::Messages::Types::ReplyInboxMessageRequestBcc }, optional: true, nullable: false
+
+          field :text, -> { String }, optional: true, nullable: false
+
+          field :html, -> { String }, optional: true, nullable: false
+
+          field :attachments, -> { Internal::Types::Array[Coss::Types::SendEmailAttachment] }, optional: true, nullable: false
+
+          field :tags, -> { Internal::Types::Array[Coss::Inboxes::Messages::Types::ReplyInboxMessageRequestTagsItem] }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/coss/inboxes/messages/types/reply_inbox_message_request_bcc.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Coss
+  module Inboxes
+    module Messages
+      module Types
+        class ReplyInboxMessageRequestBcc < Internal::Types::Model
+          extend Coss::Internal::Types::Union
+
+          member -> { String }
+
+          member -> { Internal::Types::Array[String] }
+        end
+      end
+    end
+  end
+end

data/lib/coss/inboxes/messages/types/reply_inbox_message_request_cc.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Coss
+  module Inboxes
+    module Messages
+      module Types
+        class ReplyInboxMessageRequestCc < Internal::Types::Model
+          extend Coss::Internal::Types::Union
+
+          member -> { String }
+
+          member -> { Internal::Types::Array[String] }
+        end
+      end
+    end
+  end
+end

data/lib/coss/inboxes/messages/types/reply_inbox_message_request_tags_item.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Coss
+  module Inboxes
+    module Messages
+      module Types
+        class ReplyInboxMessageRequestTagsItem < Internal::Types::Model
+          field :name, -> { String }, optional: false, nullable: false
+
+          field :value, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/coss/inboxes/messages/types/send_inbox_message_request.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Coss
+  module Inboxes
+    module Messages
+      module Types
+        class SendInboxMessageRequest < Internal::Types::Model
+          field :inbox_id, -> { String }, optional: false, nullable: false
+
+          field :idempotency_key, -> { String }, optional: true, nullable: false, api_name: "Idempotency-Key"
+
+          field :to, -> { Coss::Inboxes::Messages::Types::SendInboxMessageRequestTo }, optional: false, nullable: false
+
+          field :cc, -> { Coss::Inboxes::Messages::Types::SendInboxMessageRequestCc }, optional: true, nullable: false
+
+          field :bcc, -> { Coss::Inboxes::Messages::Types::SendInboxMessageRequestBcc }, optional: true, nullable: false
+
+          field :subject, -> { String }, optional: false, nullable: false
+
+          field :text, -> { String }, optional: true, nullable: false
+
+          field :html, -> { String }, optional: true, nullable: false
+
+          field :attachments, -> { Internal::Types::Array[Coss::Types::SendEmailAttachment] }, optional: true, nullable: false
+
+          field :tags, -> { Internal::Types::Array[Coss::Inboxes::Messages::Types::SendInboxMessageRequestTagsItem] }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end