kombo 1.2.5 → 1.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b66ea4d1c7caea85ab0b8c48dbceda178426c3c79a46778037a480f69bf94b3
-  data.tar.gz: 0a8b6be3406f62b9e71b91faf6a7dace8f1205f3ed66c640ddfdca573e6c141d
+  metadata.gz: 5cc3c59026b0df49c7d2b81dd30c9c191cc0c900324e735a7f88c953ae2cc347
+  data.tar.gz: 4fcea67cf79550cc5aaaea50fcc84deeb9d645d436e0dd8f65f0138ef0455aa4
 SHA512:
-  metadata.gz: '07810e0d4021b1370703431c505e91f2f82515ed38846f0bae8e34ac246cbd779c3806d79c1f36ed73793b8f16a6237e1a3a8b14ad2bebf7dcf64c943ade7ae8'
-  data.tar.gz: e92edfb0d9f1707d8509d1d91da8e9edd8cd77472cabe10b7dedfc90c25860b124971d5661f173b5df869f05b38cd2d34689246be7d83089cb5d0610e622e9b0
+  metadata.gz: dc234ce44c307a039445780cc37a4dd87b31eaf80a77d17baf6e418f6a758528642a76dfc25a3bbad9bfc849a41e2109c58932b9766c6441b89224444d9c529c
+  data.tar.gz: 18ca8925da6b24f9151f630309e6ba2c62f98e62b7302bd0b1b5d3b056cfd34567827f8da1e3fb6d9dca86b049b8d52bc92e5a18ceb239b2db1658695ca21e73

data/lib/kombo/ats.rb

@@ -3755,6 +3755,165 @@ module Kombo
     end
 
 
+    sig { params(integration_id: T.nilable(::String), cursor: T.nilable(::String), page_size: T.nilable(::Integer), updated_after: T.nilable(::DateTime), include_deleted: T.nilable(T::Boolean), ignore_unsupported_filters: T.nilable(T::Boolean), ids: T.nilable(T::Array[::String]), remote_ids: T.nilable(T::Array[::String]), candidate_ids: T.nilable(T::Array[::String]), application_ids: T.nilable(T::Array[::String]), timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(Models::Operations::GetAtsNotesResponse) }
+    def get_ats_notes(integration_id: nil, cursor: nil, page_size: nil, updated_after: nil, include_deleted: nil, ignore_unsupported_filters: nil, ids: nil, remote_ids: nil, candidate_ids: nil, application_ids: nil, timeout_ms: nil, http_headers: nil)
+      # get_ats_notes - Get notes
+      # Retrieve all notes.
+      #
+      # Top level filters use AND, while individual filters use OR if they accept multiple arguments. That means filters will be resolved like this: `(id IN ids) AND (remote_id IN remote_ids)`
+      request = Models::Operations::GetAtsNotesRequest.new(
+        integration_id: integration_id,
+        cursor: cursor,
+        page_size: page_size,
+        updated_after: updated_after,
+        include_deleted: include_deleted,
+        ignore_unsupported_filters: ignore_unsupported_filters,
+        ids: ids,
+        remote_ids: remote_ids,
+        candidate_ids: candidate_ids,
+        application_ids: application_ids
+      )
+      url, params = @sdk_configuration.get_server_details
+      base_url = Utils.template_url(url, params)
+      url = "#{base_url}/ats/notes"
+      headers = Utils.get_headers(request, @sdk_configuration.globals)
+      headers = T.cast(headers, T::Hash[String, String])
+      query_params = Utils.get_query_params(Models::Operations::GetAtsNotesRequest, request, nil, @sdk_configuration.globals)
+      headers['Accept'] = 'application/json'
+      headers['user-agent'] = @sdk_configuration.user_agent
+
+      security = @sdk_configuration.security_source&.call
+
+      timeout = (timeout_ms.to_f / 1000) unless timeout_ms.nil?
+      timeout ||= @sdk_configuration.timeout
+
+
+      connection = @sdk_configuration.client
+
+      hook_ctx = SDKHooks::HookContext.new(
+        config: @sdk_configuration,
+        base_url: base_url,
+        oauth2_scopes: nil,
+        operation_id: 'GetAtsNotes',
+        security_source: @sdk_configuration.security_source
+      )
+
+      error = T.let(nil, T.nilable(StandardError))
+      http_response = T.let(nil, T.nilable(Faraday::Response))
+      
+
+      begin
+        http_response = T.must(connection).get(url) do |req|
+          req.headers.merge!(headers)
+          req.options.timeout = timeout unless timeout.nil?
+          req.params = query_params
+          Utils.configure_request_security(req, security)
+          http_headers&.each do |key, value|
+            req.headers[key.to_s] = value
+          end
+
+          @sdk_configuration.hooks.before_request(
+            hook_ctx: SDKHooks::BeforeRequestHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            request: req
+          )
+        end
+      rescue StandardError => e
+        error = e
+      ensure
+        if http_response.nil? || Utils.error_status?(http_response.status)
+          http_response = @sdk_configuration.hooks.after_error(
+            error: error,
+            hook_ctx: SDKHooks::AfterErrorHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+        else
+          http_response = @sdk_configuration.hooks.after_success(
+            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+        end
+
+        if http_response.nil?
+          raise error if !error.nil?
+          raise 'no response'
+        end
+      end
+
+      content_type = http_response.headers.fetch('Content-Type', 'application/octet-stream')
+      if Utils.match_status_code(http_response.status, ['200'])
+        if Utils.match_content_type(content_type, 'application/json')
+          http_response = @sdk_configuration.hooks.after_success(
+            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+          response_data = http_response.env.response_body
+          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Shared::GetAtsNotesPositiveResponse)
+          response = Models::Operations::GetAtsNotesResponse.new(
+            status_code: http_response.status,
+            content_type: content_type,
+            raw_response: http_response,
+            get_ats_notes_positive_response: T.unsafe(obj)
+          )
+          sdk = self
+
+          response.next_page = proc do 
+            next_cursor = Janeway.enum_for('$.data.next', JSON.parse(response_data)).search
+            if next_cursor.nil?
+              next nil
+            else
+              next_cursor = next_cursor[0]
+              if next_cursor.nil?
+                next nil
+              end
+            end
+
+            sdk.get_ats_notes(
+              integration_id: request.integration_id,
+              cursor: next_cursor,
+              page_size: request.page_size,
+              updated_after: request.updated_after,
+              include_deleted: request.include_deleted,
+              ignore_unsupported_filters: request.ignore_unsupported_filters,
+              ids: request.ids,
+              remote_ids: request.remote_ids,
+              candidate_ids: request.candidate_ids,
+              application_ids: request.application_ids,
+              http_headers: http_headers
+            )
+          end
+
+
+          return response
+        else
+          raise ::Kombo::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
+        end
+      else
+        if Utils.match_content_type(content_type, 'application/json')
+          http_response = @sdk_configuration.hooks.after_success(
+            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+          response_data = http_response.env.response_body
+          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Errors::KomboAtsError)
+          obj.raw_response = http_response
+          raise obj
+        else
+          raise ::Kombo::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
+        end
+      end
+    end
+
+
     sig { params(body: Models::Shared::PostAtsImportTrackedApplicationRequestBody, integration_id: T.nilable(::String), timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(Models::Operations::PostAtsImportTrackedApplicationResponse) }
     def import_tracked_application(body:, integration_id: nil, timeout_ms: nil, http_headers: nil)
       # import_tracked_application - Import tracked application

data/lib/kombo/general.rb

@@ -390,7 +390,7 @@ module Kombo
       # |HoorayHR|`hoorayhr/api`|[HoorayHR API](https://api.hoorayhr.io/documentation/). We automatically authenticate all requests and use `https://api.hoorayhr.io` as the base URL.|
       # |HR Office|`hroffice/soap`|[HROffice SOAP API](https://api.hroffice.nl/HROfficeCoreService.asmx). We automatically authenticate all requests and wrap them in a SOAP envelope. Build the request `Body` with the raw XML parameters for your operation (e.g., `\<languageId\>1\</languageId\>`). Use `/` as your `path`. Set your `method` to `POST`. You need to specify the `api_options` object and set `operation_name` to the SOAP operation you want to call (e.g., `GetAllJobByLanguage`).|
       # |HR WORKS|`hrworks/v2`|HRWorks's v2 [API](https://developers.hrworks.de/2.0/endpoints). We automatically authenticate all requests using the customer credentials.|
-      # |HR4YOU|`hr4you/v2`|[HR4YOU's v2 API](https://apiprodemo.hr4you.org/api2/docs). We automatically authenticate all requests and use the customers provided base URL (e.g., https://`\{base_url\}`/ or https://`\{subdomain\}.hr4you.org`/).|
+      # |HR4YOU|`hr4you/v2`|[HR4YOU's v2 API](https://apiprodemo.hr4you.org/api2/docs). We automatically authenticate all requests and use the customers provided base URL (e.g. `https://your-company.hr4you.org/` or a custom domain).|
       # |Humaans|`humaans/api`|Humaans' [API](https://docs.humaans.io/api/). We automatically authenticate all requests using the API key and use `https://app.humaans.io/api` as the base URL.|
       # |iCIMS|`icims/default`|[iCIMS Default API](https://developer-community.icims.com/). We automatically authenticate all requests and use `https://api.icims.com/customers/\{customer_id\}` as the base url.|
       # |InRecruiting by Zucchetti|`inrecruiting/default`|[inRecruiting's v3 API](https://inrecruiting.intervieweb.it/api-docs/). We automatically authenticate all requests and use the customers domain as base URL|

data/lib/kombo/models/operations/getatsapplications_request.rb

@@ -28,7 +28,7 @@ module Kombo
         # | --- | --- | --- |
         # | `candidate` | n/a | ✓ Yes |
         # | `candidate` → `tags` | ✗ No | ✗ No |
-        # | `current_stage` | n/a | ✓ Yes |
+        # | `current_stage` | ✗ No | ✗ No |
         # | `job` | ✗ No | ✗ No |
         # | `interviews` | ✓ Yes | ✓ Yes |
         # | `offers` | ✓ Yes | ✓ Yes |

data/lib/kombo/models/operations/getatsnotes_request.rb

@@ -0,0 +1,82 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+
+# typed: true
+# frozen_string_literal: true
+
+
+module Kombo
+  module Models
+    module Operations
+
+      class GetAtsNotesRequest
+        extend T::Sig
+        include Crystalline::MetadataFields
+
+        # ID of the integration you want to interact with.
+        field :integration_id, Crystalline::Nilable.new(::String), { 'header': { 'field_name': 'X-Integration-Id', 'style': 'simple', 'explode': false } }
+        # An optional cursor string used for pagination. This can be retrieved from the `next` property of the previous page response.
+        field :cursor, Crystalline::Nilable.new(::String), { 'query_param': { 'field_name': 'cursor', 'style': 'form', 'explode': true } }
+        # Filter the entries based on the modification date in format `YYYY-MM-DDTHH:mm:ss.sssZ`. Returns records where either the record itself **OR** its nested data has been updated since this timestamp, even if the record's own `changed_at` field remains unchanged.
+        #
+        # If you want to track entry deletion, also set the `include_deleted=true` query parameter, because otherwise, deleted entries will be hidden.
+        #
+        # For more details, see [Understanding changed_at vs updated_after Behavior](https://docs.kombo.dev/ats/getting-started/fetching-data#understanding-changed_at-vs-updated_after-behavior).
+        #
+        # For this endpoint, `updated_after` matches when the returned record changed, or when related data changed as described below.
+        #
+        # | Path | Added/Removed | Linked Record |
+        # | --- | --- | --- |
+        # | `author` | ✗ No | ✗ No |
+        # | `application` | ✗ No | ✗ No |
+        # | `candidate` | ✗ No | ✗ No |
+        #
+        # _**Added/Removed**: Whether adding or removing entries from this list triggers an update (n/a for single records). **Linked Record**: Whether changes to the linked record itself trigger an update._
+        field :updated_after, Crystalline::Nilable.new(::DateTime), { 'query_param': { 'field_name': 'updated_after', 'style': 'form', 'explode': true } }
+        # Filter by a comma-separated list of IDs such as `222k7eCGyUdgt2JWZDNnkDs3,B5DVmypWENfU6eMe6gYDyJG3`.
+        field :ids, Crystalline::Nilable.new(Crystalline::Array.new(::String)), { 'query_param': { 'field_name': 'ids', 'style': 'form', 'explode': false } }
+        # Filter by a comma-separated list of remote IDs.
+        field :remote_ids, Crystalline::Nilable.new(Crystalline::Array.new(::String)), { 'query_param': { 'field_name': 'remote_ids', 'style': 'form', 'explode': false } }
+        # Filter by a comma-separated list of candidate IDs. Prefer filtering by `candidate_ids` when you want to download the full context available for a candidate, across all their applications.
+        field :candidate_ids, Crystalline::Nilable.new(Crystalline::Array.new(::String)), { 'query_param': { 'field_name': 'candidate_ids', 'style': 'form', 'explode': false } }
+        # Filter by a comma-separated list of application IDs. Use filtering by `application_ids` only if you want the context available for specific applications. Results do not include notes that only link to the candidate, but not the application.
+        field :application_ids, Crystalline::Nilable.new(Crystalline::Array.new(::String)), { 'query_param': { 'field_name': 'application_ids', 'style': 'form', 'explode': false } }
+        # The number of results to return per page. Maximum is 250.
+        field :page_size, Crystalline::Nilable.new(::Integer), { 'query_param': { 'field_name': 'page_size', 'style': 'form', 'explode': true } }
+        # By default, deleted entries are not returned. Use the `include_deleted` query param to include deleted entries too.
+        field :include_deleted, Crystalline::Nilable.new(Crystalline::Boolean.new), { 'query_param': { 'field_name': 'include_deleted', 'style': 'form', 'explode': true } }
+        # When set to `true`, filters targeting fields not supported by this integration will be ignored instead of filtering out all results.
+        field :ignore_unsupported_filters, Crystalline::Nilable.new(Crystalline::Boolean.new), { 'query_param': { 'field_name': 'ignore_unsupported_filters', 'style': 'form', 'explode': true } }
+
+        sig { params(integration_id: T.nilable(::String), cursor: T.nilable(::String), updated_after: T.nilable(::DateTime), ids: T.nilable(T::Array[::String]), remote_ids: T.nilable(T::Array[::String]), candidate_ids: T.nilable(T::Array[::String]), application_ids: T.nilable(T::Array[::String]), page_size: T.nilable(::Integer), include_deleted: T.nilable(T::Boolean), ignore_unsupported_filters: T.nilable(T::Boolean)).void }
+        def initialize(integration_id: nil, cursor: nil, updated_after: nil, ids: nil, remote_ids: nil, candidate_ids: nil, application_ids: nil, page_size: 100, include_deleted: false, ignore_unsupported_filters: false)
+          @integration_id = integration_id
+          @cursor = cursor
+          @updated_after = updated_after
+          @ids = ids
+          @remote_ids = remote_ids
+          @candidate_ids = candidate_ids
+          @application_ids = application_ids
+          @page_size = page_size
+          @include_deleted = include_deleted
+          @ignore_unsupported_filters = ignore_unsupported_filters
+        end
+
+        sig { params(other: T.untyped).returns(T::Boolean) }
+        def ==(other)
+          return false unless other.is_a? self.class
+          return false unless @integration_id == other.integration_id
+          return false unless @cursor == other.cursor
+          return false unless @updated_after == other.updated_after
+          return false unless @ids == other.ids
+          return false unless @remote_ids == other.remote_ids
+          return false unless @candidate_ids == other.candidate_ids
+          return false unless @application_ids == other.application_ids
+          return false unless @page_size == other.page_size
+          return false unless @include_deleted == other.include_deleted
+          return false unless @ignore_unsupported_filters == other.ignore_unsupported_filters
+          true
+        end
+      end
+    end
+  end
+end

data/lib/kombo/models/operations/getatsnotes_request.rbi

@@ -0,0 +1,31 @@
+# typed: true
+# frozen_string_literal: true
+
+
+class Kombo::Models::Operations::GetAtsNotesRequest
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+
+class Kombo::Models::Operations::GetAtsNotesRequest
+  def integration_id(); end
+  def integration_id=(str_); end
+  def cursor(); end
+  def cursor=(str_); end
+  def updated_after(); end
+  def updated_after=(str_); end
+  def ids(); end
+  def ids=(str_); end
+  def remote_ids(); end
+  def remote_ids=(str_); end
+  def candidate_ids(); end
+  def candidate_ids=(str_); end
+  def application_ids(); end
+  def application_ids=(str_); end
+  def page_size(); end
+  def page_size=(str_); end
+  def include_deleted(); end
+  def include_deleted=(str_); end
+  def ignore_unsupported_filters(); end
+  def ignore_unsupported_filters=(str_); end
+end

data/lib/kombo/models/operations/getatsnotes_response.rb

@@ -0,0 +1,56 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+
+# typed: true
+# frozen_string_literal: true
+
+
+module Kombo
+  module Models
+    module Operations
+
+      class GetAtsNotesResponse
+        extend T::Sig
+        include Crystalline::MetadataFields
+        sig { returns(T.proc.returns(T.nilable(GetAtsNotesResponse))) }
+        attr_accessor :next_page
+
+        # HTTP response content type for this operation
+        field :content_type, ::String
+        # HTTP response status code for this operation
+        field :status_code, ::Integer
+        # Raw HTTP response; suitable for custom response parsing
+        field :raw_response, ::Faraday::Response
+        # GET /ats/notes Positive response
+        field :get_ats_notes_positive_response, Crystalline::Nilable.new(Models::Shared::GetAtsNotesPositiveResponse)
+
+        sig { params(content_type: ::String, status_code: ::Integer, raw_response: ::Faraday::Response, get_ats_notes_positive_response: T.nilable(Models::Shared::GetAtsNotesPositiveResponse)).void }
+        def initialize(content_type:, status_code:, raw_response:, get_ats_notes_positive_response: nil)
+          @content_type = content_type
+          @status_code = status_code
+          @raw_response = raw_response
+          @get_ats_notes_positive_response = get_ats_notes_positive_response
+        end
+
+        sig { params(other: T.untyped).returns(T::Boolean) }
+        def ==(other)
+          return false unless other.is_a? self.class
+          return false unless @content_type == other.content_type
+          return false unless @status_code == other.status_code
+          return false unless @raw_response == other.raw_response
+          return false unless @get_ats_notes_positive_response == other.get_ats_notes_positive_response
+          true
+        end
+
+        def each
+          page = self
+          loop do
+            yield page
+            next_page = page.next_page.call if page.next_page
+            break if next_page.nil?
+            page = T.must(next_page)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/kombo/models/operations/getatsnotes_response.rbi

@@ -0,0 +1,19 @@
+# typed: true
+# frozen_string_literal: true
+
+
+class Kombo::Models::Operations::GetAtsNotesResponse
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+
+class Kombo::Models::Operations::GetAtsNotesResponse
+  def content_type(); end
+  def content_type=(str_); end
+  def status_code(); end
+  def status_code=(str_); end
+  def raw_response(); end
+  def raw_response=(str_); end
+  def get_ats_notes_positive_response(); end
+  def get_ats_notes_positive_response=(str_); end
+end

data/lib/kombo/models/operations.rb

@@ -30,6 +30,8 @@ module Kombo
       autoload :GetAtsInterviewsResponse, 'kombo/models/operations/getatsinterviews_response.rb'
       autoload :GetAtsJobsRequest, 'kombo/models/operations/getatsjobs_request.rb'
       autoload :GetAtsJobsResponse, 'kombo/models/operations/getatsjobs_response.rb'
+      autoload :GetAtsNotesRequest, 'kombo/models/operations/getatsnotes_request.rb'
+      autoload :GetAtsNotesResponse, 'kombo/models/operations/getatsnotes_response.rb'
       autoload :GetAtsOffersRequest, 'kombo/models/operations/getatsoffers_request.rb'
       autoload :GetAtsOffersResponse, 'kombo/models/operations/getatsoffers_response.rb'
       autoload :GetAtsRejectionReasonsRequest, 'kombo/models/operations/getatsrejectionreasons_request.rb'

data/lib/kombo/models/shared/author.rb

@@ -0,0 +1,48 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+
+# typed: true
+# frozen_string_literal: true
+
+
+module Kombo
+  module Models
+    module Shared
+
+      class Author
+        extend T::Sig
+        include Crystalline::MetadataFields
+
+        # The globally unique ID of this object generated by Kombo. We recommend using this as a stable primary key for syncing.
+        field :id, ::String, { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('id'), required: true } }
+        # The raw ID of the object in the remote system. We don't recommend using this as a primary key on your side as it might sometimes be compromised of multiple identifiers if a system doesn't provide a clear primary key.
+        field :remote_id, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('remote_id'), required: true } }
+        # First name of the user.
+        field :first_name, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('first_name'), required: true } }
+        # Last name of the user.
+        field :last_name, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('last_name'), required: true } }
+        # Email of the user. If the email address is invalid, it will be set to null.
+        field :email, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('email') } }
+
+        sig { params(id: ::String, remote_id: T.nilable(::String), first_name: T.nilable(::String), last_name: T.nilable(::String), email: T.nilable(::String)).void }
+        def initialize(id:, remote_id: nil, first_name: nil, last_name: nil, email: nil)
+          @id = id
+          @remote_id = remote_id
+          @first_name = first_name
+          @last_name = last_name
+          @email = email
+        end
+
+        sig { params(other: T.untyped).returns(T::Boolean) }
+        def ==(other)
+          return false unless other.is_a? self.class
+          return false unless @id == other.id
+          return false unless @remote_id == other.remote_id
+          return false unless @first_name == other.first_name
+          return false unless @last_name == other.last_name
+          return false unless @email == other.email
+          true
+        end
+      end
+    end
+  end
+end

data/lib/kombo/models/shared/author.rbi

@@ -0,0 +1,21 @@
+# typed: true
+# frozen_string_literal: true
+
+
+class Kombo::Models::Shared::Author
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+
+class Kombo::Models::Shared::Author
+  def id(); end
+  def id=(str_); end
+  def remote_id(); end
+  def remote_id=(str_); end
+  def first_name(); end
+  def first_name=(str_); end
+  def last_name(); end
+  def last_name=(str_); end
+  def email(); end
+  def email=(str_); end
+end

data/lib/kombo/models/shared/getatsnotespositiveresponse.rb

@@ -0,0 +1,39 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+
+# typed: true
+# frozen_string_literal: true
+
+
+module Kombo
+  module Models
+    module Shared
+
+      class GetAtsNotesPositiveResponse
+        extend T::Sig
+        include Crystalline::MetadataFields
+
+
+        field :data, Models::Shared::GetAtsNotesPositiveResponseData, { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('data'), required: true } }
+
+        field :status, ::String, { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('status'), required: true } }
+
+        sig { params(data: Models::Shared::GetAtsNotesPositiveResponseData, status: ::String).void }
+        def initialize(data:, status: 'success')
+          @data = data
+          unless status == 'success'
+            raise ArgumentError, 'Invalid value for status'
+          end
+          @status = 'success'
+        end
+
+        sig { params(other: T.untyped).returns(T::Boolean) }
+        def ==(other)
+          return false unless other.is_a? self.class
+          return false unless @data == other.data
+          return false unless @status == other.status
+          true
+        end
+      end
+    end
+  end
+end

data/lib/kombo/models/shared/getatsnotespositiveresponse.rbi

@@ -0,0 +1,15 @@
+# typed: true
+# frozen_string_literal: true
+
+
+class Kombo::Models::Shared::GetAtsNotesPositiveResponse
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+
+class Kombo::Models::Shared::GetAtsNotesPositiveResponse
+  def data(); end
+  def data=(str_); end
+  def status(); end
+  def status=(str_); end
+end

data/lib/kombo/models/shared/getatsnotespositiveresponse_data.rb

@@ -0,0 +1,36 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+
+# typed: true
+# frozen_string_literal: true
+
+
+module Kombo
+  module Models
+    module Shared
+
+      class GetAtsNotesPositiveResponseData
+        extend T::Sig
+        include Crystalline::MetadataFields
+
+
+        field :results, Crystalline::Array.new(Models::Shared::GetAtsNotesPositiveResponseResult), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('results'), required: true } }
+        # Cursor string that can be passed to the `cursor` query parameter to get the next page. If this is `null`, then there are no more pages.
+        field :next_, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('next'), required: true } }
+
+        sig { params(results: T::Array[Models::Shared::GetAtsNotesPositiveResponseResult], next_: T.nilable(::String)).void }
+        def initialize(results:, next_: nil)
+          @results = results
+          @next_ = next_
+        end
+
+        sig { params(other: T.untyped).returns(T::Boolean) }
+        def ==(other)
+          return false unless other.is_a? self.class
+          return false unless @results == other.results
+          return false unless @next_ == other.next_
+          true
+        end
+      end
+    end
+  end
+end

data/lib/kombo/models/shared/getatsnotespositiveresponse_data.rbi

@@ -0,0 +1,15 @@
+# typed: true
+# frozen_string_literal: true
+
+
+class Kombo::Models::Shared::GetAtsNotesPositiveResponseData
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+
+class Kombo::Models::Shared::GetAtsNotesPositiveResponseData
+  def results(); end
+  def results=(str_); end
+  def next_(); end
+  def next_=(str_); end
+end

data/lib/kombo/models/shared/getatsnotespositiveresponse_result.rb

@@ -0,0 +1,84 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+
+# typed: true
+# frozen_string_literal: true
+
+
+module Kombo
+  module Models
+    module Shared
+
+      class GetAtsNotesPositiveResponseResult
+        extend T::Sig
+        include Crystalline::MetadataFields
+
+        # The globally unique ID of this object generated by Kombo. We recommend using this as a stable primary key for syncing.
+        field :id, ::String, { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('id'), required: true } }
+        # The raw ID of the object in the remote system. We don't recommend using this as a primary key on your side as it might sometimes be compromised of multiple identifiers if a system doesn't provide a clear primary key.
+        field :remote_id, ::String, { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('remote_id'), required: true } }
+        # The Kombo ID of the candidate this note is about. The ID can be used to retrieve the candidate from the `get candidates` endpoint.
+        field :candidate_id, ::String, { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('candidate_id'), required: true } }
+        # The timestamp when this specific record was last modified. This field only updates when properties directly on this record change, NOT when related or nested models change. For filtering that considers nested data changes, use the `updated_after` parameter which will return records when either the record itself OR its related models have been updated.
+        # https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString
+        field :changed_at, ::DateTime, { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('changed_at'), required: true, 'decoder': ::Kombo::Utils.datetime_from_iso_format(false) } }
+        # The Kombo ID of the application this note is about, when the note is tied to a specific application. Some systems attach notes to the candidate only, in which case this is `null`.
+        field :application_id, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('application_id'), required: true } }
+        # The Kombo ID of the user who authored the note. `null` for notes generated by the system rather than a specific user. The ID can be used to retrieve the user from the `get users` endpoint.
+        field :author_id, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('author_id'), required: true } }
+        # The note title from the ATS.
+        field :title, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('title'), required: true } }
+        # The note content from the ATS, passed through as-is. This may contain HTML markup when the source ATS stores it that way.
+        field :content_html, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('content_html'), required: true } }
+        # Whether the note requires elevated permissions to access in the source ATS (e.g. a `private`, `secret`, or `admin only` flag), meaning it is not visible to everyone with standard access to the candidate/application. `null` when the source ATS does not expose such a signal.
+        field :is_private, Crystalline::Nilable.new(Crystalline::Boolean.new), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('is_private'), required: true } }
+        # The date and time the object was created in the remote system.
+        # https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString
+        field :remote_created_at, Crystalline::Nilable.new(::DateTime), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('remote_created_at'), required: true, 'decoder': ::Kombo::Utils.datetime_from_iso_format(false) } }
+        # A timestamp retrieved from the remote system, describing when the resource was last updated.
+        # https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString
+        field :remote_updated_at, Crystalline::Nilable.new(::DateTime), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('remote_updated_at'), required: true, 'decoder': ::Kombo::Utils.datetime_from_iso_format(false) } }
+        # The date and time the object was deleted in the remote system. Objects are automatically marked as deleted when Kombo can't retrieve them from the remote system anymore. Kombo will also anonymize entries 14 days after they disappear.
+        # https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString
+        field :remote_deleted_at, Crystalline::Nilable.new(::DateTime), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('remote_deleted_at'), required: true, 'decoder': ::Kombo::Utils.datetime_from_iso_format(false) } }
+
+        field :author, Crystalline::Nilable.new(Models::Shared::Author), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('author'), required: true } }
+
+        sig { params(id: ::String, remote_id: ::String, candidate_id: ::String, changed_at: ::DateTime, application_id: T.nilable(::String), author_id: T.nilable(::String), title: T.nilable(::String), content_html: T.nilable(::String), is_private: T.nilable(T::Boolean), remote_created_at: T.nilable(::DateTime), remote_updated_at: T.nilable(::DateTime), remote_deleted_at: T.nilable(::DateTime), author: T.nilable(Models::Shared::Author)).void }
+        def initialize(id:, remote_id:, candidate_id:, changed_at:, application_id: nil, author_id: nil, title: nil, content_html: nil, is_private: nil, remote_created_at: nil, remote_updated_at: nil, remote_deleted_at: nil, author: nil)
+          @id = id
+          @remote_id = remote_id
+          @candidate_id = candidate_id
+          @changed_at = changed_at
+          @application_id = application_id
+          @author_id = author_id
+          @title = title
+          @content_html = content_html
+          @is_private = is_private
+          @remote_created_at = remote_created_at
+          @remote_updated_at = remote_updated_at
+          @remote_deleted_at = remote_deleted_at
+          @author = author
+        end
+
+        sig { params(other: T.untyped).returns(T::Boolean) }
+        def ==(other)
+          return false unless other.is_a? self.class
+          return false unless @id == other.id
+          return false unless @remote_id == other.remote_id
+          return false unless @candidate_id == other.candidate_id
+          return false unless @changed_at == other.changed_at
+          return false unless @application_id == other.application_id
+          return false unless @author_id == other.author_id
+          return false unless @title == other.title
+          return false unless @content_html == other.content_html
+          return false unless @is_private == other.is_private
+          return false unless @remote_created_at == other.remote_created_at
+          return false unless @remote_updated_at == other.remote_updated_at
+          return false unless @remote_deleted_at == other.remote_deleted_at
+          return false unless @author == other.author
+          true
+        end
+      end
+    end
+  end
+end

data/lib/kombo/models/shared/getatsnotespositiveresponse_result.rbi

@@ -0,0 +1,37 @@
+# typed: true
+# frozen_string_literal: true
+
+
+class Kombo::Models::Shared::GetAtsNotesPositiveResponseResult
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+
+class Kombo::Models::Shared::GetAtsNotesPositiveResponseResult
+  def id(); end
+  def id=(str_); end
+  def remote_id(); end
+  def remote_id=(str_); end
+  def candidate_id(); end
+  def candidate_id=(str_); end
+  def changed_at(); end
+  def changed_at=(str_); end
+  def application_id(); end
+  def application_id=(str_); end
+  def author_id(); end
+  def author_id=(str_); end
+  def title(); end
+  def title=(str_); end
+  def content_html(); end
+  def content_html=(str_); end
+  def is_private(); end
+  def is_private=(str_); end
+  def remote_created_at(); end
+  def remote_created_at=(str_); end
+  def remote_updated_at(); end
+  def remote_updated_at=(str_); end
+  def remote_deleted_at(); end
+  def remote_deleted_at=(str_); end
+  def author(); end
+  def author=(str_); end
+end

data/lib/kombo/models/shared/gethrisabsencespositiveresponse_type.rb

@@ -27,12 +27,14 @@ module Kombo
         field :half_days_supported, Crystalline::Nilable.new(Crystalline::Boolean.new), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('half_days_supported'), required: true } }
         # `true` if the system supports exact times (absences with a `start_time` and an `end_time`) for this absence, `false` if not.
         field :exact_times_supported, Crystalline::Nilable.new(Crystalline::Boolean.new), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('exact_times_supported'), required: true } }
+        # A key-value store of fields not covered by the schema. [Read more](/custom-fields)
+        field :custom_fields, Crystalline::Nilable.new(Crystalline::Hash.new(Symbol, ::Object)), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('custom_fields'), required: true } }
         # The date and time the object was deleted in the remote system. Objects are automatically marked as deleted when Kombo can't retrieve them from the remote system anymore. Kombo will also anonymize entries 14 days after they disappear.
         # https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString
         field :remote_deleted_at, Crystalline::Nilable.new(::DateTime), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('remote_deleted_at'), required: true, 'decoder': ::Kombo::Utils.datetime_from_iso_format(false) } }
 
-        sig { params(id: ::String, remote_id: ::String, changed_at: ::DateTime, name: T.nilable(::String), unit: T.nilable(Models::Shared::GetHrisAbsencesPositiveResponseTypeUnit), half_days_supported: T.nilable(T::Boolean), exact_times_supported: T.nilable(T::Boolean), remote_deleted_at: T.nilable(::DateTime)).void }
-        def initialize(id:, remote_id:, changed_at:, name: nil, unit: nil, half_days_supported: nil, exact_times_supported: nil, remote_deleted_at: nil)
+        sig { params(id: ::String, remote_id: ::String, changed_at: ::DateTime, name: T.nilable(::String), unit: T.nilable(Models::Shared::GetHrisAbsencesPositiveResponseTypeUnit), half_days_supported: T.nilable(T::Boolean), exact_times_supported: T.nilable(T::Boolean), custom_fields: T.nilable(T::Hash[Symbol, ::Object]), remote_deleted_at: T.nilable(::DateTime)).void }
+        def initialize(id:, remote_id:, changed_at:, name: nil, unit: nil, half_days_supported: nil, exact_times_supported: nil, custom_fields: nil, remote_deleted_at: nil)
           @id = id
           @remote_id = remote_id
           @changed_at = changed_at
@@ -40,6 +42,7 @@ module Kombo
           @unit = unit
           @half_days_supported = half_days_supported
           @exact_times_supported = exact_times_supported
+          @custom_fields = custom_fields
           @remote_deleted_at = remote_deleted_at
         end
 
@@ -53,6 +56,7 @@ module Kombo
           return false unless @unit == other.unit
           return false unless @half_days_supported == other.half_days_supported
           return false unless @exact_times_supported == other.exact_times_supported
+          return false unless @custom_fields == other.custom_fields
           return false unless @remote_deleted_at == other.remote_deleted_at
           true
         end

data/lib/kombo/models/shared/gethrisabsencespositiveresponse_type.rbi

@@ -22,6 +22,8 @@ class Kombo::Models::Shared::GetHrisAbsencesPositiveResponseType
   def half_days_supported=(str_); end
   def exact_times_supported(); end
   def exact_times_supported=(str_); end
+  def custom_fields(); end
+  def custom_fields=(str_); end
   def remote_deleted_at(); end
   def remote_deleted_at=(str_); end
 end

data/lib/kombo/models/shared/gethrisabsencetypespositiveresponse_result.rb

@@ -27,12 +27,14 @@ module Kombo
         field :half_days_supported, Crystalline::Nilable.new(Crystalline::Boolean.new), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('half_days_supported'), required: true } }
         # `true` if the system supports exact times (absences with a `start_time` and an `end_time`) for this absence, `false` if not.
         field :exact_times_supported, Crystalline::Nilable.new(Crystalline::Boolean.new), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('exact_times_supported'), required: true } }
+        # A key-value store of fields not covered by the schema. [Read more](/custom-fields)
+        field :custom_fields, Crystalline::Nilable.new(Crystalline::Hash.new(Symbol, ::Object)), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('custom_fields'), required: true } }
         # The date and time the object was deleted in the remote system. Objects are automatically marked as deleted when Kombo can't retrieve them from the remote system anymore. Kombo will also anonymize entries 14 days after they disappear.
         # https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString
         field :remote_deleted_at, Crystalline::Nilable.new(::DateTime), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('remote_deleted_at'), required: true, 'decoder': ::Kombo::Utils.datetime_from_iso_format(false) } }
 
-        sig { params(id: ::String, remote_id: ::String, changed_at: ::DateTime, name: T.nilable(::String), unit: T.nilable(Models::Shared::GetHrisAbsenceTypesPositiveResponseUnit), half_days_supported: T.nilable(T::Boolean), exact_times_supported: T.nilable(T::Boolean), remote_deleted_at: T.nilable(::DateTime)).void }
-        def initialize(id:, remote_id:, changed_at:, name: nil, unit: nil, half_days_supported: nil, exact_times_supported: nil, remote_deleted_at: nil)
+        sig { params(id: ::String, remote_id: ::String, changed_at: ::DateTime, name: T.nilable(::String), unit: T.nilable(Models::Shared::GetHrisAbsenceTypesPositiveResponseUnit), half_days_supported: T.nilable(T::Boolean), exact_times_supported: T.nilable(T::Boolean), custom_fields: T.nilable(T::Hash[Symbol, ::Object]), remote_deleted_at: T.nilable(::DateTime)).void }
+        def initialize(id:, remote_id:, changed_at:, name: nil, unit: nil, half_days_supported: nil, exact_times_supported: nil, custom_fields: nil, remote_deleted_at: nil)
           @id = id
           @remote_id = remote_id
           @changed_at = changed_at
@@ -40,6 +42,7 @@ module Kombo
           @unit = unit
           @half_days_supported = half_days_supported
           @exact_times_supported = exact_times_supported
+          @custom_fields = custom_fields
           @remote_deleted_at = remote_deleted_at
         end
 
@@ -53,6 +56,7 @@ module Kombo
           return false unless @unit == other.unit
           return false unless @half_days_supported == other.half_days_supported
           return false unless @exact_times_supported == other.exact_times_supported
+          return false unless @custom_fields == other.custom_fields
           return false unless @remote_deleted_at == other.remote_deleted_at
           true
         end

data/lib/kombo/models/shared/gethrisabsencetypespositiveresponse_result.rbi

@@ -22,6 +22,8 @@ class Kombo::Models::Shared::GetHrisAbsenceTypesPositiveResponseResult
   def half_days_supported=(str_); end
   def exact_times_supported(); end
   def exact_times_supported=(str_); end
+  def custom_fields(); end
+  def custom_fields=(str_); end
   def remote_deleted_at(); end
   def remote_deleted_at=(str_); end
 end

data/lib/kombo/models/shared/gethristimeoffbalancespositiveresponse_type.rb

@@ -27,12 +27,14 @@ module Kombo
         field :half_days_supported, Crystalline::Nilable.new(Crystalline::Boolean.new), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('half_days_supported'), required: true } }
         # `true` if the system supports exact times (absences with a `start_time` and an `end_time`) for this absence, `false` if not.
         field :exact_times_supported, Crystalline::Nilable.new(Crystalline::Boolean.new), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('exact_times_supported'), required: true } }
+        # A key-value store of fields not covered by the schema. [Read more](/custom-fields)
+        field :custom_fields, Crystalline::Nilable.new(Crystalline::Hash.new(Symbol, ::Object)), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('custom_fields'), required: true } }
         # The date and time the object was deleted in the remote system. Objects are automatically marked as deleted when Kombo can't retrieve them from the remote system anymore. Kombo will also anonymize entries 14 days after they disappear.
         # https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString
         field :remote_deleted_at, Crystalline::Nilable.new(::DateTime), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('remote_deleted_at'), required: true, 'decoder': ::Kombo::Utils.datetime_from_iso_format(false) } }
 
-        sig { params(id: ::String, remote_id: ::String, changed_at: ::DateTime, name: T.nilable(::String), unit: T.nilable(Models::Shared::GetHrisTimeOffBalancesPositiveResponseUnit), half_days_supported: T.nilable(T::Boolean), exact_times_supported: T.nilable(T::Boolean), remote_deleted_at: T.nilable(::DateTime)).void }
-        def initialize(id:, remote_id:, changed_at:, name: nil, unit: nil, half_days_supported: nil, exact_times_supported: nil, remote_deleted_at: nil)
+        sig { params(id: ::String, remote_id: ::String, changed_at: ::DateTime, name: T.nilable(::String), unit: T.nilable(Models::Shared::GetHrisTimeOffBalancesPositiveResponseUnit), half_days_supported: T.nilable(T::Boolean), exact_times_supported: T.nilable(T::Boolean), custom_fields: T.nilable(T::Hash[Symbol, ::Object]), remote_deleted_at: T.nilable(::DateTime)).void }
+        def initialize(id:, remote_id:, changed_at:, name: nil, unit: nil, half_days_supported: nil, exact_times_supported: nil, custom_fields: nil, remote_deleted_at: nil)
           @id = id
           @remote_id = remote_id
           @changed_at = changed_at
@@ -40,6 +42,7 @@ module Kombo
           @unit = unit
           @half_days_supported = half_days_supported
           @exact_times_supported = exact_times_supported
+          @custom_fields = custom_fields
           @remote_deleted_at = remote_deleted_at
         end
 
@@ -53,6 +56,7 @@ module Kombo
           return false unless @unit == other.unit
           return false unless @half_days_supported == other.half_days_supported
           return false unless @exact_times_supported == other.exact_times_supported
+          return false unless @custom_fields == other.custom_fields
           return false unless @remote_deleted_at == other.remote_deleted_at
           true
         end

data/lib/kombo/models/shared/gethristimeoffbalancespositiveresponse_type.rbi

@@ -22,6 +22,8 @@ class Kombo::Models::Shared::GetHrisTimeOffBalancesPositiveResponseType
   def half_days_supported=(str_); end
   def exact_times_supported(); end
   def exact_times_supported=(str_); end
+  def custom_fields(); end
+  def custom_fields=(str_); end
   def remote_deleted_at(); end
   def remote_deleted_at=(str_); end
 end

data/lib/kombo/models/shared/name.rb

@@ -39,6 +39,7 @@ module Kombo
           ATS_OFFERS = new('ats_offers')
           ATS_REJECTION_REASONS = new('ats_rejection_reasons')
           ATS_ROLES = new('ats_roles')
+          ATS_NOTES = new('ats_notes')
           LMS_USERS = new('lms_users')
           LMS_COURSE_PROVIDERS = new('lms_course_providers')
           LMS_SKILLS = new('lms_skills')

data/lib/kombo/models/shared/postatscandidatesrequestbody_bullhorn.rb

@@ -16,11 +16,14 @@ module Kombo
         field :candidate, Crystalline::Nilable.new(Crystalline::Hash.new(Symbol, ::Object)), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('candidate') } }
         # Fields that we will pass through to Bullhorn's `JobSubmission` object.
         field :job_submission, Crystalline::Nilable.new(Crystalline::Hash.new(Symbol, ::Object)), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('job_submission') } }
+        # The remote ID of the Bullhorn `Candidate` the application should be filed on. When set, we skip Bullhorn's duplicate detection and use exactly this candidate, which lets you pick the right record when several candidates share an email address or phone number. The request fails if the candidate does not exist (or was deleted) in Bullhorn.
+        field :existing_candidate_remote_id, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('existing_candidate_remote_id') } }
 
-        sig { params(candidate: T.nilable(T::Hash[Symbol, ::Object]), job_submission: T.nilable(T::Hash[Symbol, ::Object])).void }
-        def initialize(candidate: nil, job_submission: nil)
+        sig { params(candidate: T.nilable(T::Hash[Symbol, ::Object]), job_submission: T.nilable(T::Hash[Symbol, ::Object]), existing_candidate_remote_id: T.nilable(::String)).void }
+        def initialize(candidate: nil, job_submission: nil, existing_candidate_remote_id: nil)
           @candidate = candidate
           @job_submission = job_submission
+          @existing_candidate_remote_id = existing_candidate_remote_id
         end
 
         sig { params(other: T.untyped).returns(T::Boolean) }
@@ -28,6 +31,7 @@ module Kombo
           return false unless other.is_a? self.class
           return false unless @candidate == other.candidate
           return false unless @job_submission == other.job_submission
+          return false unless @existing_candidate_remote_id == other.existing_candidate_remote_id
           true
         end
       end

data/lib/kombo/models/shared/postatscandidatesrequestbody_bullhorn.rbi

@@ -12,4 +12,6 @@ class Kombo::Models::Shared::PostAtsCandidatesRequestBodyBullhorn
   def candidate=(str_); end
   def job_submission(); end
   def job_submission=(str_); end
+  def existing_candidate_remote_id(); end
+  def existing_candidate_remote_id=(str_); end
 end

data/lib/kombo/models/shared/postatscandidatesrequestbody_piloga_candidate.rb

@@ -14,16 +14,21 @@ module Kombo
 
         # The street address of the candidate.
         field :street, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('street') } }
+        # The birth date of the candidate, written into the "Geburtsdatum" field of the application form. Format: `YYYY-MM-DD`
+        # https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString
+        field :geburtsdatum, Crystalline::Nilable.new(::DateTime), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('geburtsdatum'), 'decoder': ::Kombo::Utils.datetime_from_iso_format(true) } }
 
-        sig { params(street: T.nilable(::String)).void }
-        def initialize(street: nil)
+        sig { params(street: T.nilable(::String), geburtsdatum: T.nilable(::DateTime)).void }
+        def initialize(street: nil, geburtsdatum: nil)
           @street = street
+          @geburtsdatum = geburtsdatum
         end
 
         sig { params(other: T.untyped).returns(T::Boolean) }
         def ==(other)
           return false unless other.is_a? self.class
           return false unless @street == other.street
+          return false unless @geburtsdatum == other.geburtsdatum
           true
         end
       end

data/lib/kombo/models/shared/postatscandidatesrequestbody_piloga_candidate.rbi

@@ -10,4 +10,6 @@ end
 class Kombo::Models::Shared::PostAtsCandidatesRequestBodyPilogaCandidate
   def street(); end
   def street=(str_); end
+  def geburtsdatum(); end
+  def geburtsdatum=(str_); end
 end

data/lib/kombo/models/shared/postatsjobsjobidapplicationsrequestbody_bullhorn.rb

@@ -16,11 +16,14 @@ module Kombo
         field :candidate, Crystalline::Nilable.new(Crystalline::Hash.new(Symbol, ::Object)), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('candidate') } }
         # Fields that we will pass through to Bullhorn's `JobSubmission` object.
         field :job_submission, Crystalline::Nilable.new(Crystalline::Hash.new(Symbol, ::Object)), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('job_submission') } }
+        # The remote ID of the Bullhorn `Candidate` the application should be filed on. When set, we skip Bullhorn's duplicate detection and use exactly this candidate, which lets you pick the right record when several candidates share an email address or phone number. The request fails if the candidate does not exist (or was deleted) in Bullhorn.
+        field :existing_candidate_remote_id, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('existing_candidate_remote_id') } }
 
-        sig { params(candidate: T.nilable(T::Hash[Symbol, ::Object]), job_submission: T.nilable(T::Hash[Symbol, ::Object])).void }
-        def initialize(candidate: nil, job_submission: nil)
+        sig { params(candidate: T.nilable(T::Hash[Symbol, ::Object]), job_submission: T.nilable(T::Hash[Symbol, ::Object]), existing_candidate_remote_id: T.nilable(::String)).void }
+        def initialize(candidate: nil, job_submission: nil, existing_candidate_remote_id: nil)
           @candidate = candidate
           @job_submission = job_submission
+          @existing_candidate_remote_id = existing_candidate_remote_id
         end
 
         sig { params(other: T.untyped).returns(T::Boolean) }
@@ -28,6 +31,7 @@ module Kombo
           return false unless other.is_a? self.class
           return false unless @candidate == other.candidate
           return false unless @job_submission == other.job_submission
+          return false unless @existing_candidate_remote_id == other.existing_candidate_remote_id
           true
         end
       end

data/lib/kombo/models/shared/postatsjobsjobidapplicationsrequestbody_bullhorn.rbi

@@ -12,4 +12,6 @@ class Kombo::Models::Shared::PostAtsJobsJobIdApplicationsRequestBodyBullhorn
   def candidate=(str_); end
   def job_submission(); end
   def job_submission=(str_); end
+  def existing_candidate_remote_id(); end
+  def existing_candidate_remote_id=(str_); end
 end

data/lib/kombo/models/shared/postatsjobsjobidapplicationsrequestbody_piloga_candidate.rb

@@ -14,16 +14,21 @@ module Kombo
 
         # The street address of the candidate.
         field :street, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('street') } }
+        # The birth date of the candidate, written into the "Geburtsdatum" field of the application form. Format: `YYYY-MM-DD`
+        # https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString
+        field :geburtsdatum, Crystalline::Nilable.new(::DateTime), { 'format_json': { 'letter_case': ::Kombo::Utils.field_name('geburtsdatum'), 'decoder': ::Kombo::Utils.datetime_from_iso_format(true) } }
 
-        sig { params(street: T.nilable(::String)).void }
-        def initialize(street: nil)
+        sig { params(street: T.nilable(::String), geburtsdatum: T.nilable(::DateTime)).void }
+        def initialize(street: nil, geburtsdatum: nil)
           @street = street
+          @geburtsdatum = geburtsdatum
         end
 
         sig { params(other: T.untyped).returns(T::Boolean) }
         def ==(other)
           return false unless other.is_a? self.class
           return false unless @street == other.street
+          return false unless @geburtsdatum == other.geburtsdatum
           true
         end
       end

data/lib/kombo/models/shared/postatsjobsjobidapplicationsrequestbody_piloga_candidate.rbi

@@ -10,4 +10,6 @@ end
 class Kombo::Models::Shared::PostAtsJobsJobIdApplicationsRequestBodyPilogaCandidate
   def street(); end
   def street=(str_); end
+  def geburtsdatum(); end
+  def geburtsdatum=(str_); end
 end

data/lib/kombo/models/shared.rb

@@ -144,6 +144,9 @@ module Kombo
       autoload :GetAtsJobsPositiveResponseStatus, 'kombo/models/shared/getatsjobspositiveresponse_status.rb'
       autoload :GetAtsJobsPositiveResponseUnifiedType, 'kombo/models/shared/getatsjobspositiveresponse_unified_type.rb'
       autoload :GetAtsJobsPositiveResponseVisibility, 'kombo/models/shared/getatsjobspositiveresponse_visibility.rb'
+      autoload :GetAtsNotesPositiveResponse, 'kombo/models/shared/getatsnotespositiveresponse.rb'
+      autoload :GetAtsNotesPositiveResponseData, 'kombo/models/shared/getatsnotespositiveresponse_data.rb'
+      autoload :GetAtsNotesPositiveResponseResult, 'kombo/models/shared/getatsnotespositiveresponse_result.rb'
       autoload :GetAtsOffersPositiveResponse, 'kombo/models/shared/getatsofferspositiveresponse.rb'
       autoload :GetAtsOffersPositiveResponseApplication, 'kombo/models/shared/getatsofferspositiveresponse_application.rb'
       autoload :GetAtsOffersPositiveResponseCandidate, 'kombo/models/shared/getatsofferspositiveresponse_candidate.rb'
@@ -811,6 +814,7 @@ module Kombo
       autoload :AttributeSubResult, 'kombo/models/shared/attribute_subresult.rb'
       autoload :AttributeText, 'kombo/models/shared/attribute_text.rb'
       autoload :AttributeStatus, 'kombo/models/shared/attribute_status.rb'
+      autoload :Author, 'kombo/models/shared/author.rb'
       autoload :BankAccount, 'kombo/models/shared/bank_account.rb'
       autoload :BenefitTypeId, 'kombo/models/shared/benefit_type_id.rb'
       autoload :Break, 'kombo/models/shared/break_.rb'

data/lib/kombo/sdkconfiguration.rb

@@ -97,9 +97,9 @@ module Kombo
       @globals = globals.nil? ? {} : globals
       @language = 'ruby'
       @openapi_doc_version = '1.0.0'
-      @sdk_version = '1.2.5'
-      @gen_version = '2.924.0'
-      @user_agent = 'speakeasy-sdk/ruby 1.2.5 2.924.0 1.0.0 kombo'
+      @sdk_version = '1.2.7'
+      @gen_version = '2.928.0'
+      @user_agent = 'speakeasy-sdk/ruby 1.2.7 2.928.0 1.0.0 kombo'
     end
 
     sig { returns([String, T::Hash[Symbol, String]]) }

data/lib/kombo/utils/retries.rb

@@ -4,6 +4,7 @@
 # frozen_string_literal: true
 
 require 'faraday/retry'
+require 'time'
 require 'sorbet-runtime'
 
 module Kombo
@@ -87,12 +88,50 @@ module Kombo
             retry_options[:retry_if] = ->(_env, _exc) { Time.now < stop_time }
           end
 
-          retry_options[:rate_limit_retry_header] = 'retry-after-ms'
-          retry_options[:header_parser_block] = ->(value) { value.to_f / 1000 }
         end
 
         retry_options
       end
     end
+
+    class RetryMiddleware < Faraday::Retry::Middleware
+      extend T::Sig
+
+      sig { params(retries: T.untyped, env: T.untyped).returns(T.untyped) }
+      def calculate_sleep_amount(retries, env)
+        retry_after = [calculate_retry_after(env), calculate_rate_limit_reset(env)].compact.max
+        retry_interval = calculate_retry_interval(retries)
+        return retry_interval if retry_after.nil?
+
+        # unlike the stock middleware, cap server delays at max_interval rather
+        # than abandoning the retry
+        [[retry_after, @options.max_interval].min, retry_interval].max
+      end
+
+      private
+
+      sig { params(env: T.untyped).returns(T.untyped) }
+      def calculate_retry_after(env)
+        response_headers = env[:response_headers]
+        return unless response_headers
+
+        ms_value = response_headers['retry-after-ms']
+        return ms_value.to_f / 1000 if ms_value&.match?(/\A\s*\d+\s*\z/)
+
+        value = response_headers['retry-after']
+        return if value.nil? || value.strip.empty?
+        return value.to_f if value.match?(/\A\s*\d+\s*\z/)
+
+        begin
+          Time.httpdate(value) - Time.now
+        rescue ArgumentError
+          begin
+            Time.iso8601(value) - Time.now
+          rescue ArgumentError
+            nil
+          end
+        end
+      end
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kombo
 version: !ruby/object:Gem::Version
-  version: 1.2.5
+  version: 1.2.7
 platform: ruby
 authors:
 - Kombo Technologies GmbH
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-07-28 00:00:00.000000000 Z
+date: 2026-08-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -346,6 +346,10 @@ files:
 - lib/kombo/models/operations/getatsjobs_request.rbi
 - lib/kombo/models/operations/getatsjobs_response.rb
 - lib/kombo/models/operations/getatsjobs_response.rbi
+- lib/kombo/models/operations/getatsnotes_request.rb
+- lib/kombo/models/operations/getatsnotes_request.rbi
+- lib/kombo/models/operations/getatsnotes_response.rb
+- lib/kombo/models/operations/getatsnotes_response.rbi
 - lib/kombo/models/operations/getatsoffers_request.rb
 - lib/kombo/models/operations/getatsoffers_request.rbi
 - lib/kombo/models/operations/getatsoffers_response.rb
@@ -577,6 +581,8 @@ files:
 - lib/kombo/models/shared/attribute_subresult.rbi
 - lib/kombo/models/shared/attribute_text.rb
 - lib/kombo/models/shared/attribute_text.rbi
+- lib/kombo/models/shared/author.rb
+- lib/kombo/models/shared/author.rbi
 - lib/kombo/models/shared/bank_account.rb
 - lib/kombo/models/shared/bank_account.rbi
 - lib/kombo/models/shared/benefit_type_id.rb
@@ -893,6 +899,12 @@ files:
 - lib/kombo/models/shared/getatsjobspositiveresponse_unified_type.rbi
 - lib/kombo/models/shared/getatsjobspositiveresponse_visibility.rb
 - lib/kombo/models/shared/getatsjobspositiveresponse_visibility.rbi
+- lib/kombo/models/shared/getatsnotespositiveresponse.rb
+- lib/kombo/models/shared/getatsnotespositiveresponse.rbi
+- lib/kombo/models/shared/getatsnotespositiveresponse_data.rb
+- lib/kombo/models/shared/getatsnotespositiveresponse_data.rbi
+- lib/kombo/models/shared/getatsnotespositiveresponse_result.rb
+- lib/kombo/models/shared/getatsnotespositiveresponse_result.rbi
 - lib/kombo/models/shared/getatsofferspositiveresponse.rb
 - lib/kombo/models/shared/getatsofferspositiveresponse.rbi
 - lib/kombo/models/shared/getatsofferspositiveresponse_application.rb