merge_ruby_client 0.0.3 → 0.0.5

data/lib/merge_ruby_client/ats/issues/client.rb

@@ -10,12 +10,12 @@ require "async"
 module Merge
   module Ats
     class IssuesClient
+      # @return [Merge::RequestClient]
       attr_reader :request_client
 
-      # @param request_client [RequestClient]
-      # @return [Ats::IssuesClient]
+      # @param request_client [Merge::RequestClient]
+      # @return [Merge::Ats::IssuesClient]
       def initialize(request_client:)
-        # @type [RequestClient]
         @request_client = request_client
       end
 
@@ -23,24 +23,37 @@ module Merge
       #
       # @param account_token [String]
       # @param cursor [String] The pagination cursor value.
-      # @param end_date [String] If included, will only include issues whose most recent action occurred before this time
+      # @param end_date [String] If included, will only include issues whose most recent action occurred before
+      #  this time
       # @param end_user_organization_name [String]
-      # @param first_incident_time_after [DateTime] If provided, will only return issues whose first incident time was after this datetime.
-      # @param first_incident_time_before [DateTime] If provided, will only return issues whose first incident time was before this datetime.
-      # @param include_muted [String] If True, will include muted issues
+      # @param first_incident_time_after [DateTime] If provided, will only return issues whose first incident time was after this
+      #  datetime.
+      # @param first_incident_time_before [DateTime] If provided, will only return issues whose first incident time was before this
+      #  datetime.
+      # @param include_muted [String] If true, will include muted issues
       # @param integration_name [String]
-      # @param last_incident_time_after [DateTime] If provided, will only return issues whose last incident time was after this datetime.
-      # @param last_incident_time_before [DateTime] If provided, will only return issues whose last incident time was before this datetime.
+      # @param last_incident_time_after [DateTime] If provided, will only return issues whose last incident time was after this
+      #  datetime.
+      # @param last_incident_time_before [DateTime] If provided, will only return issues whose last incident time was before this
+      #  datetime.
       # @param page_size [Integer] Number of results to return per page.
-      # @param start_date [String] If included, will only include issues whose most recent action occurred after this time
-      # @param status [ISSUES_LIST_REQUEST_STATUS] Status of the issue. Options: ('ONGOING', 'RESOLVED')
-      #   - `ONGOING` - ONGOING
-      #   - `RESOLVED` - RESOLVED
-      # @param request_options [RequestOptions]
-      # @return [Ats::PaginatedIssueList]
+      # @param start_date [String] If included, will only include issues whose most recent action occurred after
+      #  this time
+      # @param status [Merge::Ats::Issues::IssuesListRequestStatus] Status of the issue. Options: ('ONGOING', 'RESOLVED')
+      #  - `ONGOING` - ONGOING
+      #  - `RESOLVED` - RESOLVED
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Ats::PaginatedIssueList]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.ats.list
       def list(account_token: nil, cursor: nil, end_date: nil, end_user_organization_name: nil,
                first_incident_time_after: nil, first_incident_time_before: nil, include_muted: nil, integration_name: nil, last_incident_time_after: nil, last_incident_time_before: nil, page_size: nil, start_date: nil, status: nil, request_options: nil)
-        response = @request_client.conn.get("/api/ats/v1/issues") do |req|
+        response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
           req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
           req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -61,33 +74,42 @@ module Merge
             "start_date": start_date,
             "status": status
           }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/ats/v1/issues"
         end
-        Ats::PaginatedIssueList.from_json(json_object: response.body)
+        Merge::Ats::PaginatedIssueList.from_json(json_object: response.body)
       end
 
       # Get a specific issue.
       #
       # @param id [String]
-      # @param request_options [RequestOptions]
-      # @return [Ats::Issue]
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Ats::Issue]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.ats.retrieve(id: "id")
       def retrieve(id:, request_options: nil)
-        response = @request_client.conn.get("/api/ats/v1/issues/#{id}") do |req|
+        response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
           req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
           req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
           req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/ats/v1/issues/#{id}"
         end
-        Ats::Issue.from_json(json_object: response.body)
+        Merge::Ats::Issue.from_json(json_object: response.body)
       end
     end
 
     class AsyncIssuesClient
+      # @return [Merge::AsyncRequestClient]
       attr_reader :request_client
 
-      # @param request_client [AsyncRequestClient]
-      # @return [Ats::AsyncIssuesClient]
+      # @param request_client [Merge::AsyncRequestClient]
+      # @return [Merge::Ats::AsyncIssuesClient]
       def initialize(request_client:)
-        # @type [AsyncRequestClient]
         @request_client = request_client
       end
 
@@ -95,25 +117,38 @@ module Merge
       #
       # @param account_token [String]
       # @param cursor [String] The pagination cursor value.
-      # @param end_date [String] If included, will only include issues whose most recent action occurred before this time
+      # @param end_date [String] If included, will only include issues whose most recent action occurred before
+      #  this time
       # @param end_user_organization_name [String]
-      # @param first_incident_time_after [DateTime] If provided, will only return issues whose first incident time was after this datetime.
-      # @param first_incident_time_before [DateTime] If provided, will only return issues whose first incident time was before this datetime.
-      # @param include_muted [String] If True, will include muted issues
+      # @param first_incident_time_after [DateTime] If provided, will only return issues whose first incident time was after this
+      #  datetime.
+      # @param first_incident_time_before [DateTime] If provided, will only return issues whose first incident time was before this
+      #  datetime.
+      # @param include_muted [String] If true, will include muted issues
       # @param integration_name [String]
-      # @param last_incident_time_after [DateTime] If provided, will only return issues whose last incident time was after this datetime.
-      # @param last_incident_time_before [DateTime] If provided, will only return issues whose last incident time was before this datetime.
+      # @param last_incident_time_after [DateTime] If provided, will only return issues whose last incident time was after this
+      #  datetime.
+      # @param last_incident_time_before [DateTime] If provided, will only return issues whose last incident time was before this
+      #  datetime.
       # @param page_size [Integer] Number of results to return per page.
-      # @param start_date [String] If included, will only include issues whose most recent action occurred after this time
-      # @param status [ISSUES_LIST_REQUEST_STATUS] Status of the issue. Options: ('ONGOING', 'RESOLVED')
-      #   - `ONGOING` - ONGOING
-      #   - `RESOLVED` - RESOLVED
-      # @param request_options [RequestOptions]
-      # @return [Ats::PaginatedIssueList]
+      # @param start_date [String] If included, will only include issues whose most recent action occurred after
+      #  this time
+      # @param status [Merge::Ats::Issues::IssuesListRequestStatus] Status of the issue. Options: ('ONGOING', 'RESOLVED')
+      #  - `ONGOING` - ONGOING
+      #  - `RESOLVED` - RESOLVED
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Ats::PaginatedIssueList]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.ats.list
       def list(account_token: nil, cursor: nil, end_date: nil, end_user_organization_name: nil,
                first_incident_time_after: nil, first_incident_time_before: nil, include_muted: nil, integration_name: nil, last_incident_time_after: nil, last_incident_time_before: nil, page_size: nil, start_date: nil, status: nil, request_options: nil)
         Async do
-          response = @request_client.conn.get("/api/ats/v1/issues") do |req|
+          response = @request_client.conn.get do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
             req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
             req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -134,25 +169,34 @@ module Merge
               "start_date": start_date,
               "status": status
             }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/ats/v1/issues"
           end
-          Ats::PaginatedIssueList.from_json(json_object: response.body)
+          Merge::Ats::PaginatedIssueList.from_json(json_object: response.body)
         end
       end
 
       # Get a specific issue.
       #
       # @param id [String]
-      # @param request_options [RequestOptions]
-      # @return [Ats::Issue]
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Ats::Issue]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.ats.retrieve(id: "id")
       def retrieve(id:, request_options: nil)
         Async do
-          response = @request_client.conn.get("/api/ats/v1/issues/#{id}") do |req|
+          response = @request_client.conn.get do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
             req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
             req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
             req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/ats/v1/issues/#{id}"
           end
-          Ats::Issue.from_json(json_object: response.body)
+          Merge::Ats::Issue.from_json(json_object: response.body)
         end
       end
     end

data/lib/merge_ruby_client/ats/issues/types/issues_list_request_status.rb

@@ -3,8 +3,10 @@
 module Merge
   module Ats
     class Issues
-      # @type [ISSUES_LIST_REQUEST_STATUS]
-      ISSUES_LIST_REQUEST_STATUS = { ongoing: "ONGOING", resolved: "RESOLVED" }.freeze
+      class IssuesListRequestStatus
+        ONGOING = "ONGOING"
+        RESOLVED = "RESOLVED"
+      end
     end
   end
 end

data/lib/merge_ruby_client/ats/job_interview_stages/client.rb

@@ -9,12 +9,12 @@ require "async"
 module Merge
   module Ats
     class JobInterviewStagesClient
+      # @return [Merge::RequestClient]
       attr_reader :request_client
 
-      # @param request_client [RequestClient]
-      # @return [Ats::JobInterviewStagesClient]
+      # @param request_client [Merge::RequestClient]
+      # @return [Merge::Ats::JobInterviewStagesClient]
       def initialize(request_client:)
-        # @type [RequestClient]
         @request_client = request_client
       end
 
@@ -23,19 +23,29 @@ module Merge
       # @param created_after [DateTime] If provided, will only return objects created after this datetime.
       # @param created_before [DateTime] If provided, will only return objects created before this datetime.
       # @param cursor [String] The pagination cursor value.
-      # @param expand [String] Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
+      # @param expand [String] Which relations should be returned in expanded form. Multiple relation names
+      #  should be comma separated without spaces.
       # @param include_deleted_data [Boolean] Whether to include data that was marked as deleted by third party webhooks.
-      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to produce these models.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
       # @param job_id [String] If provided, will only return interview stages for this job.
       # @param modified_after [DateTime] If provided, only objects synced by Merge after this date time will be returned.
-      # @param modified_before [DateTime] If provided, only objects synced by Merge before this date time will be returned.
+      # @param modified_before [DateTime] If provided, only objects synced by Merge before this date time will be
+      #  returned.
       # @param page_size [Integer] Number of results to return per page.
       # @param remote_id [String] The API provider's ID for the given object.
-      # @param request_options [RequestOptions]
-      # @return [Ats::PaginatedJobInterviewStageList]
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Ats::PaginatedJobInterviewStageList]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.ats.list
       def list(created_after: nil, created_before: nil, cursor: nil, expand: nil, include_deleted_data: nil,
                include_remote_data: nil, job_id: nil, modified_after: nil, modified_before: nil, page_size: nil, remote_id: nil, request_options: nil)
-        response = @request_client.conn.get("/api/ats/v1/job-interview-stages") do |req|
+        response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
           req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
           req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -54,19 +64,29 @@ module Merge
             "page_size": page_size,
             "remote_id": remote_id
           }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/ats/v1/job-interview-stages"
         end
-        Ats::PaginatedJobInterviewStageList.from_json(json_object: response.body)
+        Merge::Ats::PaginatedJobInterviewStageList.from_json(json_object: response.body)
       end
 
       # Returns a `JobInterviewStage` object with the given `id`.
       #
       # @param id [String]
-      # @param expand [String] Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
-      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to produce these models.
-      # @param request_options [RequestOptions]
-      # @return [Ats::JobInterviewStage]
+      # @param expand [String] Which relations should be returned in expanded form. Multiple relation names
+      #  should be comma separated without spaces.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Ats::JobInterviewStage]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.ats.retrieve(id: "id")
       def retrieve(id:, expand: nil, include_remote_data: nil, request_options: nil)
-        response = @request_client.conn.get("/api/ats/v1/job-interview-stages/#{id}") do |req|
+        response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
           req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
           req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -76,18 +96,19 @@ module Merge
             "expand": expand,
             "include_remote_data": include_remote_data
           }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/ats/v1/job-interview-stages/#{id}"
         end
-        Ats::JobInterviewStage.from_json(json_object: response.body)
+        Merge::Ats::JobInterviewStage.from_json(json_object: response.body)
       end
     end
 
     class AsyncJobInterviewStagesClient
+      # @return [Merge::AsyncRequestClient]
       attr_reader :request_client
 
-      # @param request_client [AsyncRequestClient]
-      # @return [Ats::AsyncJobInterviewStagesClient]
+      # @param request_client [Merge::AsyncRequestClient]
+      # @return [Merge::Ats::AsyncJobInterviewStagesClient]
       def initialize(request_client:)
-        # @type [AsyncRequestClient]
         @request_client = request_client
       end
 
@@ -96,20 +117,30 @@ module Merge
       # @param created_after [DateTime] If provided, will only return objects created after this datetime.
       # @param created_before [DateTime] If provided, will only return objects created before this datetime.
       # @param cursor [String] The pagination cursor value.
-      # @param expand [String] Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
+      # @param expand [String] Which relations should be returned in expanded form. Multiple relation names
+      #  should be comma separated without spaces.
       # @param include_deleted_data [Boolean] Whether to include data that was marked as deleted by third party webhooks.
-      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to produce these models.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
       # @param job_id [String] If provided, will only return interview stages for this job.
       # @param modified_after [DateTime] If provided, only objects synced by Merge after this date time will be returned.
-      # @param modified_before [DateTime] If provided, only objects synced by Merge before this date time will be returned.
+      # @param modified_before [DateTime] If provided, only objects synced by Merge before this date time will be
+      #  returned.
       # @param page_size [Integer] Number of results to return per page.
       # @param remote_id [String] The API provider's ID for the given object.
-      # @param request_options [RequestOptions]
-      # @return [Ats::PaginatedJobInterviewStageList]
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Ats::PaginatedJobInterviewStageList]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.ats.list
       def list(created_after: nil, created_before: nil, cursor: nil, expand: nil, include_deleted_data: nil,
                include_remote_data: nil, job_id: nil, modified_after: nil, modified_before: nil, page_size: nil, remote_id: nil, request_options: nil)
         Async do
-          response = @request_client.conn.get("/api/ats/v1/job-interview-stages") do |req|
+          response = @request_client.conn.get do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
             req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
             req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -128,21 +159,31 @@ module Merge
               "page_size": page_size,
               "remote_id": remote_id
             }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/ats/v1/job-interview-stages"
           end
-          Ats::PaginatedJobInterviewStageList.from_json(json_object: response.body)
+          Merge::Ats::PaginatedJobInterviewStageList.from_json(json_object: response.body)
         end
       end
 
       # Returns a `JobInterviewStage` object with the given `id`.
       #
       # @param id [String]
-      # @param expand [String] Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
-      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to produce these models.
-      # @param request_options [RequestOptions]
-      # @return [Ats::JobInterviewStage]
+      # @param expand [String] Which relations should be returned in expanded form. Multiple relation names
+      #  should be comma separated without spaces.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Ats::JobInterviewStage]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.ats.retrieve(id: "id")
       def retrieve(id:, expand: nil, include_remote_data: nil, request_options: nil)
         Async do
-          response = @request_client.conn.get("/api/ats/v1/job-interview-stages/#{id}") do |req|
+          response = @request_client.conn.get do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
             req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
             req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -152,8 +193,9 @@ module Merge
               "expand": expand,
               "include_remote_data": include_remote_data
             }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/ats/v1/job-interview-stages/#{id}"
           end
-          Ats::JobInterviewStage.from_json(json_object: response.body)
+          Merge::Ats::JobInterviewStage.from_json(json_object: response.body)
         end
       end
     end

data/lib/merge_ruby_client/ats/job_postings/client.rb

@@ -0,0 +1,216 @@
+# frozen_string_literal: true
+
+require_relative "../../../requests"
+require "date"
+require_relative "types/job_postings_list_request_status"
+require_relative "../types/paginated_job_posting_list"
+require_relative "../types/job_posting"
+require "async"
+
+module Merge
+  module Ats
+    class JobPostingsClient
+      # @return [Merge::RequestClient]
+      attr_reader :request_client
+
+      # @param request_client [Merge::RequestClient]
+      # @return [Merge::Ats::JobPostingsClient]
+      def initialize(request_client:)
+        @request_client = request_client
+      end
+
+      # Returns a list of `JobPosting` objects.
+      #
+      # @param created_after [DateTime] If provided, will only return objects created after this datetime.
+      # @param created_before [DateTime] If provided, will only return objects created before this datetime.
+      # @param cursor [String] The pagination cursor value.
+      # @param expand [String] Which relations should be returned in expanded form. Multiple relation names
+      #  should be comma separated without spaces.
+      # @param include_deleted_data [Boolean] Whether to include data that was marked as deleted by third party webhooks.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
+      # @param modified_after [DateTime] If provided, only objects synced by Merge after this date time will be returned.
+      # @param modified_before [DateTime] If provided, only objects synced by Merge before this date time will be
+      #  returned.
+      # @param page_size [Integer] Number of results to return per page.
+      # @param remote_id [String] The API provider's ID for the given object.
+      # @param status [Merge::Ats::JobPostings::JobPostingsListRequestStatus] If provided, will only return Job Postings with this status. Options:
+      #  ('PUBLISHED', 'CLOSED', 'DRAFT', 'INTERNAL', 'PENDING')
+      #  - `PUBLISHED` - PUBLISHED
+      #  - `CLOSED` - CLOSED
+      #  - `DRAFT` - DRAFT
+      #  - `INTERNAL` - INTERNAL
+      #  - `PENDING` - PENDING
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Ats::PaginatedJobPostingList]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.ats.list
+      def list(created_after: nil, created_before: nil, cursor: nil, expand: nil, include_deleted_data: nil,
+               include_remote_data: nil, modified_after: nil, modified_before: nil, page_size: nil, remote_id: nil, status: nil, request_options: nil)
+        response = @request_client.conn.get do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+          req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+          req.params = {
+            **(request_options&.additional_query_parameters || {}),
+            "created_after": created_after,
+            "created_before": created_before,
+            "cursor": cursor,
+            "expand": expand,
+            "include_deleted_data": include_deleted_data,
+            "include_remote_data": include_remote_data,
+            "modified_after": modified_after,
+            "modified_before": modified_before,
+            "page_size": page_size,
+            "remote_id": remote_id,
+            "status": status
+          }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/ats/v1/job-postings"
+        end
+        Merge::Ats::PaginatedJobPostingList.from_json(json_object: response.body)
+      end
+
+      # Returns a `JobPosting` object with the given `id`.
+      #
+      # @param id [String]
+      # @param expand [String] Which relations should be returned in expanded form. Multiple relation names
+      #  should be comma separated without spaces.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Ats::JobPosting]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.ats.retrieve(id: "id")
+      def retrieve(id:, expand: nil, include_remote_data: nil, request_options: nil)
+        response = @request_client.conn.get do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+          req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+          req.params = {
+            **(request_options&.additional_query_parameters || {}),
+            "expand": expand,
+            "include_remote_data": include_remote_data
+          }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/ats/v1/job-postings/#{id}"
+        end
+        Merge::Ats::JobPosting.from_json(json_object: response.body)
+      end
+    end
+
+    class AsyncJobPostingsClient
+      # @return [Merge::AsyncRequestClient]
+      attr_reader :request_client
+
+      # @param request_client [Merge::AsyncRequestClient]
+      # @return [Merge::Ats::AsyncJobPostingsClient]
+      def initialize(request_client:)
+        @request_client = request_client
+      end
+
+      # Returns a list of `JobPosting` objects.
+      #
+      # @param created_after [DateTime] If provided, will only return objects created after this datetime.
+      # @param created_before [DateTime] If provided, will only return objects created before this datetime.
+      # @param cursor [String] The pagination cursor value.
+      # @param expand [String] Which relations should be returned in expanded form. Multiple relation names
+      #  should be comma separated without spaces.
+      # @param include_deleted_data [Boolean] Whether to include data that was marked as deleted by third party webhooks.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
+      # @param modified_after [DateTime] If provided, only objects synced by Merge after this date time will be returned.
+      # @param modified_before [DateTime] If provided, only objects synced by Merge before this date time will be
+      #  returned.
+      # @param page_size [Integer] Number of results to return per page.
+      # @param remote_id [String] The API provider's ID for the given object.
+      # @param status [Merge::Ats::JobPostings::JobPostingsListRequestStatus] If provided, will only return Job Postings with this status. Options:
+      #  ('PUBLISHED', 'CLOSED', 'DRAFT', 'INTERNAL', 'PENDING')
+      #  - `PUBLISHED` - PUBLISHED
+      #  - `CLOSED` - CLOSED
+      #  - `DRAFT` - DRAFT
+      #  - `INTERNAL` - INTERNAL
+      #  - `PENDING` - PENDING
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Ats::PaginatedJobPostingList]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.ats.list
+      def list(created_after: nil, created_before: nil, cursor: nil, expand: nil, include_deleted_data: nil,
+               include_remote_data: nil, modified_after: nil, modified_before: nil, page_size: nil, remote_id: nil, status: nil, request_options: nil)
+        Async do
+          response = @request_client.conn.get do |req|
+            req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+            req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+            req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+            req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+            req.params = {
+              **(request_options&.additional_query_parameters || {}),
+              "created_after": created_after,
+              "created_before": created_before,
+              "cursor": cursor,
+              "expand": expand,
+              "include_deleted_data": include_deleted_data,
+              "include_remote_data": include_remote_data,
+              "modified_after": modified_after,
+              "modified_before": modified_before,
+              "page_size": page_size,
+              "remote_id": remote_id,
+              "status": status
+            }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/ats/v1/job-postings"
+          end
+          Merge::Ats::PaginatedJobPostingList.from_json(json_object: response.body)
+        end
+      end
+
+      # Returns a `JobPosting` object with the given `id`.
+      #
+      # @param id [String]
+      # @param expand [String] Which relations should be returned in expanded form. Multiple relation names
+      #  should be comma separated without spaces.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Ats::JobPosting]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.ats.retrieve(id: "id")
+      def retrieve(id:, expand: nil, include_remote_data: nil, request_options: nil)
+        Async do
+          response = @request_client.conn.get do |req|
+            req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+            req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+            req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+            req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+            req.params = {
+              **(request_options&.additional_query_parameters || {}),
+              "expand": expand,
+              "include_remote_data": include_remote_data
+            }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/ats/v1/job-postings/#{id}"
+          end
+          Merge::Ats::JobPosting.from_json(json_object: response.body)
+        end
+      end
+    end
+  end
+end

data/lib/merge_ruby_client/ats/job_postings/types/job_postings_list_request_status.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Merge
+  module Ats
+    class JobPostings
+      class JobPostingsListRequestStatus
+        CLOSED = "CLOSED"
+        DRAFT = "DRAFT"
+        INTERNAL = "INTERNAL"
+        PENDING = "PENDING"
+        PUBLISHED = "PUBLISHED"
+      end
+    end
+  end
+end