coss 0.1.0 → 0.2.0

data/lib/coss/email/subaccounts/types/update_subaccount_request.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Coss
+  module Email
+    module Subaccounts
+      module Types
+        class UpdateSubaccountRequest < Internal::Types::Model
+          field :subaccount, -> { String }, optional: false, nullable: false
+
+          field :name, -> { String }, optional: true, nullable: false
+
+          field :uid, -> { String }, optional: true, nullable: false
+
+          field :metadata, -> { Internal::Types::Hash[String, String] }, optional: true, nullable: false
+
+          field :status, -> { Coss::Email::Subaccounts::Types::UpdateSubaccountRequestStatus }, optional: true, nullable: false
+
+          field :quotas, -> { Coss::Email::Subaccounts::Types::UpdateSubaccountRequestQuotas }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/coss/email/subaccounts/types/update_subaccount_request_quotas.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Coss
+  module Email
+    module Subaccounts
+      module Types
+        # Fields left out keep their value; `null` removes a quota.
+        class UpdateSubaccountRequestQuotas < Internal::Types::Model
+          field :recipients_per_day, -> { Integer }, optional: true, nullable: false
+
+          field :recipients_per_second, -> { Integer }, optional: true, nullable: false
+
+          field :burst, -> { Integer }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/coss/email/subaccounts/types/update_subaccount_request_status.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Coss
+  module Email
+    module Subaccounts
+      module Types
+        module UpdateSubaccountRequestStatus
+          extend Coss::Internal::Types::Enum
+
+          ACTIVE = "active"
+          DISABLED = "disabled"
+        end
+      end
+    end
+  end
+end

data/lib/coss/email/suppressions/client.rb

@@ -21,18 +21,20 @@ module Coss
         # @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, nil] :subaccount
         # @option params [String, nil] :address
         # @option params [Coss::Types::ListSuppressionsRequestScope, nil] :scope
         # @option params [Integer, nil] :limit
         # @option params [String, nil] :after
         #
         # @example
-        #   client.email.suppressions.list
+        #   client.email.suppressions.list(subaccount: "user_8812")
         #
         # @return [Coss::Types::SuppressionList]
         def list(request_options: {}, **params)
           params = Coss::Internal::Types::Utils.normalize_keys(params)
           query_params = {}
+          query_params["subaccount"] = params[:subaccount] if params.key?(:subaccount)
           query_params["address"] = params[:address] if params.key?(:address)
           query_params["scope"] = params[:scope] if params.key?(:scope)
           query_params["limit"] = params[:limit] if params.key?(:limit)
@@ -116,6 +118,7 @@ module Coss
         # @option params [String] :address
         # @option params [String, nil] :category
         # @option params [Coss::Email::Suppressions::Types::CheckSuppressionsRequestStream, nil] :stream
+        # @option params [String, nil] :subaccount
         #
         # @example
         #   client.email.suppressions.check(address: "user@example.com")
@@ -127,6 +130,7 @@ module Coss
           query_params["address"] = params[:address] if params.key?(:address)
           query_params["category"] = params[:category] if params.key?(:category)
           query_params["stream"] = params[:stream] if params.key?(:stream)
+          query_params["subaccount"] = params[:subaccount] if params.key?(:subaccount)
 
           request = Coss::Internal::JSON::Request.new(
             base_url: request_options[:base_url],
@@ -206,6 +210,7 @@ module Coss
         # @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, nil] :subaccount
         # @option params [Coss::Types::ExportSuppressionsRequestScope, nil] :scope
         # @option params [Coss::Email::Suppressions::Types::ExportSuppressionsRequestReason, nil] :reason
         #
@@ -216,6 +221,7 @@ module Coss
         def export(request_options: {}, **params)
           params = Coss::Internal::Types::Utils.normalize_keys(params)
           query_params = {}
+          query_params["subaccount"] = params[:subaccount] if params.key?(:subaccount)
           query_params["scope"] = params[:scope] if params.key?(:scope)
           query_params["reason"] = params[:reason] if params.key?(:reason)
 

data/lib/coss/email/suppressions/types/check_suppressions_request.rb

@@ -10,6 +10,8 @@ module Coss
           field :category, -> { String }, optional: true, nullable: false
 
           field :stream, -> { Coss::Email::Suppressions::Types::CheckSuppressionsRequestStream }, optional: true, nullable: false
+
+          field :subaccount, -> { String }, optional: true, nullable: false
         end
       end
     end

data/lib/coss/email/suppressions/types/create_suppression_request.rb

@@ -8,6 +8,8 @@ module Coss
           field :address, -> { String }, optional: false, nullable: false
 
           field :scope, -> { Coss::Email::Suppressions::Types::CreateSuppressionRequestScope }, optional: true, nullable: false
+
+          field :subaccount, -> { String }, optional: true, nullable: false
         end
       end
     end

data/lib/coss/email/suppressions/types/export_suppressions_request.rb

@@ -5,6 +5,8 @@ module Coss
     module Suppressions
       module Types
         class ExportSuppressionsRequest < Internal::Types::Model
+          field :subaccount, -> { String }, optional: true, nullable: false
+
           field :scope, -> { Coss::Types::ExportSuppressionsRequestScope }, optional: true, nullable: false
 
           field :reason, -> { Coss::Email::Suppressions::Types::ExportSuppressionsRequestReason }, optional: true, nullable: false

data/lib/coss/email/suppressions/types/import_suppressions_request.rb

@@ -5,6 +5,8 @@ module Coss
     module Suppressions
       module Types
         class ImportSuppressionsRequest < Internal::Types::Model
+          field :subaccount, -> { String }, optional: true, nullable: false
+
           field :suppressions, -> { Internal::Types::Array[Coss::Email::Suppressions::Types::ImportSuppressionsRequestSuppressionsItem] }, optional: false, nullable: false
         end
       end

data/lib/coss/email/suppressions/types/list_suppressions_request.rb

@@ -5,6 +5,8 @@ module Coss
     module Suppressions
       module Types
         class ListSuppressionsRequest < Internal::Types::Model
+          field :subaccount, -> { String }, optional: true, nullable: false
+
           field :address, -> { String }, optional: true, nullable: false
 
           field :scope, -> { Coss::Types::ListSuppressionsRequestScope }, optional: true, nullable: false

data/lib/coss/email/types/list_email_request.rb

@@ -16,6 +16,8 @@ module Coss
 
         field :batch_id, -> { String }, optional: true, nullable: false
 
+        field :subaccount, -> { String }, optional: true, nullable: false
+
         field :created_after, -> { String }, optional: true, nullable: false
 
         field :created_before, -> { String }, optional: true, nullable: false

data/lib/coss/forms/client.rb

@@ -0,0 +1,233 @@
+# frozen_string_literal: true
+
+module Coss
+  module Forms
+    class Client
+      # @param client [Coss::Internal::Http::RawClient]
+      #
+      # @return [void]
+      def initialize(client:)
+        @client = client
+      end
+
+      # The environment's forms, newest first.
+      #
+      # @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.forms.list
+      #
+      # @return [Coss::Types::FormList]
+      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/forms",
+          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::FormList.load(response.body))
+        else
+          error_class = Coss::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # A hosted form endpoint: point an HTML `<form action>` (or `coss/forms`) at its `endpoint`. Every submission is
+      # screened by Risk (the honeypot, captcha, email, IP, device, velocity and content) and accepted ones go to
+      # webhooks (`form.submission.received`), notification emails and contacts. Without `fields`, any field is
+      # accepted.
+      #
+      # @param request_options [Hash]
+      # @param params [Coss::Forms::Types::CreateFormRequest]
+      # @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.forms.create(
+      #     name: "Contact us",
+      #     allowed_origins: ["https://www.example.com"],
+      #     notifications: {
+      #       recipients: ["support@example.com"]
+      #     }
+      #   )
+      #
+      # @return [Coss::Types::Form]
+      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/forms",
+          headers: headers,
+          body: Coss::Forms::Types::CreateFormRequest.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::Form.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] :id
+      #
+      # @example
+      #   client.forms.get(id: "form_01kd2m8n3p4q5r6s7t8v9w0x1y")
+      #
+      # @return [Coss::Types::Form]
+      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/forms/#{URI.encode_uri_component(params[: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::Form.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 form with every submission and uploaded file. Its endpoint answers 404 from then on.
+      #
+      # @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] :id
+      #
+      # @example
+      #   client.forms.remove(id: "form_01kd2m8n3p4q5r6s7t8v9w0x1y")
+      #
+      # @return [Coss::Types::DeletedForm]
+      def remove(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/forms/#{URI.encode_uri_component(params[: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::DeletedForm.load(response.body))
+        else
+          error_class = Coss::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Only the fields given change, within each group (`spam`, `contacts`, …) too.
+      #
+      # @param request_options [Hash]
+      # @param params [Coss::Forms::Types::UpdateFormRequest]
+      # @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] :id
+      #
+      # @example
+      #   client.forms.update(
+      #     id: "form_01kd2m8n3p4q5r6s7t8v9w0x1y",
+      #     spam: {
+      #       captcha: "required"
+      #     },
+      #     contacts: {
+      #       enabled: true
+      #     }
+      #   )
+      #
+      # @return [Coss::Types::Form]
+      def update(request_options: {}, **params)
+        params = Coss::Internal::Types::Utils.normalize_keys(params)
+        request_data = Coss::Forms::Types::UpdateFormRequest.new(params).to_h
+        non_body_param_names = %w[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/forms/#{URI.encode_uri_component(params[: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::Form.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::Submissions::Client]
+      def submissions
+        @submissions ||= Coss::Forms::Submissions::Client.new(client: @client)
+      end
+    end
+  end
+end

data/lib/coss/forms/submissions/client.rb

@@ -0,0 +1,229 @@
+# frozen_string_literal: true
+
+module Coss
+  module Forms
+    module Submissions
+      class Client
+        # @param client [Coss::Internal::Http::RawClient]
+        #
+        # @return [void]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Newest first. `status` narrows them: `accepted` (delivered), `held` (Risk asked for a review), `spam` and
+        # `pending_confirmation` (waiting for the submitter's email link).
+        #
+        # @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] :id
+        # @option params [String, nil] :status
+        # @option params [Integer, nil] :limit
+        # @option params [String, nil] :after
+        #
+        # @example
+        #   client.forms.submissions.list(id: "form_01kd2m8n3p4q5r6s7t8v9w0x1y")
+        #
+        # @return [Coss::Types::FormSubmissionList]
+        def list(request_options: {}, **params)
+          params = Coss::Internal::Types::Utils.normalize_keys(params)
+          query_params = {}
+          query_params["status"] = params[:status] if params.key?(:status)
+          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/forms/#{URI.encode_uri_component(params[:id].to_s)}/submissions",
+            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::FormSubmissionList.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] :id
+        # @option params [String] :submission_id
+        #
+        # @example
+        #   client.forms.submissions.get(
+        #     id: "form_01kd2m8n3p4q5r6s7t8v9w0x1y",
+        #     submission_id: "fsub_01kd2m9a0b1c2d3e4f5g6h7j8k"
+        #   )
+        #
+        # @return [Coss::Types::FormSubmission]
+        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/forms/#{URI.encode_uri_component(params[:id].to_s)}/submissions/#{URI.encode_uri_component(params[:submission_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::FormSubmission.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 submission and its files.
+        #
+        # @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] :id
+        # @option params [String] :submission_id
+        #
+        # @example
+        #   client.forms.submissions.remove(
+        #     id: "form_01kd2m8n3p4q5r6s7t8v9w0x1y",
+        #     submission_id: "fsub_01kd2m9a0b1c2d3e4f5g6h7j8k"
+        #   )
+        #
+        # @return [Coss::Types::DeletedFormSubmission]
+        def remove(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/forms/#{URI.encode_uri_component(params[:id].to_s)}/submissions/#{URI.encode_uri_component(params[:submission_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::DeletedFormSubmission.load(response.body))
+          else
+            error_class = Coss::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # Not spam: a `held` or `spam` submission becomes `accepted` and is delivered (webhooks, notifications,
+        # contacts), and Risk records its assessment as `legitimate`. Releasing an accepted submission returns it as is.
+        #
+        # @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] :id
+        # @option params [String] :submission_id
+        #
+        # @example
+        #   client.forms.submissions.release(
+        #     id: "form_01kd2m8n3p4q5r6s7t8v9w0x1y",
+        #     submission_id: "fsub_01kd2m9a0b1c2d3e4f5g6h7j8k"
+        #   )
+        #
+        # @return [Coss::Types::FormSubmission]
+        def release(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/forms/#{URI.encode_uri_component(params[:id].to_s)}/submissions/#{URI.encode_uri_component(params[:submission_id].to_s)}/release",
+            headers: headers,
+            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::FormSubmission.load(response.body))
+          else
+            error_class = Coss::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # A file uploaded with the submission, as `application/octet-stream`: whatever its type, treat it as untrusted
+        # (a submitter chose it).
+        #
+        # @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] :id
+        # @option params [String] :submission_id
+        # @option params [String] :file_id
+        #
+        # @example
+        #   client.forms.submissions.file(
+        #     id: "id",
+        #     submission_id: "submission_id",
+        #     file_id: "file_id"
+        #   )
+        #
+        # @return [untyped]
+        def file(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/forms/#{URI.encode_uri_component(params[:id].to_s)}/submissions/#{URI.encode_uri_component(params[:submission_id].to_s)}/files/#{URI.encode_uri_component(params[:file_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
+      end
+    end
+  end
+end

data/lib/coss/forms/submissions/types/file_submissions_request.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Coss
+  module Forms
+    module Submissions
+      module Types
+        class FileSubmissionsRequest < Internal::Types::Model
+          field :id, -> { String }, optional: false, nullable: false
+
+          field :submission_id, -> { String }, optional: false, nullable: false
+
+          field :file_id, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/coss/forms/submissions/types/get_submissions_request.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Coss
+  module Forms
+    module Submissions
+      module Types
+        class GetSubmissionsRequest < Internal::Types::Model
+          field :id, -> { String }, optional: false, nullable: false
+
+          field :submission_id, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end