crisphive 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1ea71e345767c63c9580d0c9d27e917eac5b39841795b58a1168c8e087a8d750
+  data.tar.gz: 6b6a8e958bec2b6bbd18780b48a9b9eeabc03639d65bd13ad71aab74f0b07713
+SHA512:
+  metadata.gz: d1c0cb7cf0c4935756695f2d586d1cd8aa4a8134fef772137bb2825dbec04e253b824a49e6439a4ba93af6c71adf61834d500a4928eaadd1b120db80c341dbc8
+  data.tar.gz: 944ca1a86086463ed7ebaa5ecd4afb886786c24c7d424ae5dc3a1cc5d6caa640cc461d114cab1aa98d2a2667d09698f16e10817ed5c94151a3989432f8f326f4

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+gemspec
+
+group :development, :test do
+  gem 'rake', '~> 13.0.1'
+  gem 'pry-byebug'
+  gem 'rubocop', '~> 0.66.0'
+end

data/README.md

@@ -0,0 +1,219 @@
+# crisphive
+
+Crisphive - the Ruby gem for the CrispHive Developer API
+
+Public REST API for integrating CrispHive from your own backend. Authenticate every request with a secret API key as a Bearer token (`Authorization: Bearer chsk_live_…`). The key prefix selects the data environment: `chsk_live_…` → production (live), `chsk_test_…` → sandbox (isolated test).
+
+**Key scopes (restricted keys).** A key is either *full-access* (can call every endpoint below) or *restricted* to a set of permission codes chosen at creation — the same codes as the dashboard permission grid (e.g. `customers_view`, `job_create`, `team_manage`). A restricted key calling an endpoint outside its scope gets `403`. The full code list is the permission catalog (`GET /permission/modules` on the dashboard API). Create, scope, and revoke keys from the business dashboard.
+
+Every response is wrapped in the envelope `{ \"error_code\": 0, \"message\": \"Success\", \"data\": <payload> }`.
+
+This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
+
+- API version: 1.0
+- Package version: 0.1.0
+- Generator version: 7.11.0
+- Build package: org.openapitools.codegen.languages.RubyClientCodegen
+
+## Installation
+
+### Build a gem
+
+To build the Ruby code into a gem:
+
+```shell
+gem build crisphive.gemspec
+```
+
+Then either install the gem locally:
+
+```shell
+gem install ./crisphive-0.1.0.gem
+```
+
+(for development, run `gem install --dev ./crisphive-0.1.0.gem` to install the development dependencies)
+
+or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
+
+Finally add this to the Gemfile:
+
+    gem 'crisphive', '~> 0.1.0'
+
+### Install from Git
+
+If the Ruby gem is hosted at a git repository: https://github.com/crisphive/crisphive-ruby, then add the following in the Gemfile:
+
+    gem 'crisphive', :git => 'https://github.com/crisphive/crisphive-ruby.git'
+
+### Include the Ruby code directly
+
+Include the Ruby code directly using `-I` as follows:
+
+```shell
+ruby -Ilib script.rb
+```
+
+## Getting Started
+
+Please follow the [installation](#installation) procedure and then run the following code:
+
+```ruby
+# Load the gem
+require 'crisphive'
+
+# Setup authorization
+Crisphive.configure do |config|
+  # Configure Bearer authorization (CrispHive secret key): ApiKeyAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+  # Configure a proc to get access tokens in lieu of the static access_token configuration
+  config.access_token_getter = -> { 'YOUR TOKEN GETTER PROC' } 
+  # Configure faraday connection
+  config.configure_faraday_connection { |connection| 'YOUR CONNECTION CONFIG PROC' }
+end
+
+api_instance = Crisphive::BusinessSkillApi.new
+opts = {
+  page: 56, # Integer | Page number (default: 1)
+  limit: 56 # Integer | Page size (default: 15, max: 1000)
+}
+
+begin
+  #List skill categories
+  result = api_instance.list_skill_categories(opts)
+  p result
+rescue Crisphive::ApiError => e
+  puts "Exception when calling BusinessSkillApi->list_skill_categories: #{e}"
+end
+
+```
+
+## Documentation for API Endpoints
+
+All URIs are relative to *https://api.crisphive.com/v1*
+
+Class | Method | HTTP request | Description
+------------ | ------------- | ------------- | -------------
+*Crisphive::BusinessSkillApi* | [**list_skill_categories**](docs/BusinessSkillApi.md#list_skill_categories) | **GET** /skill-categories | List skill categories
+*Crisphive::BusinessSkillApi* | [**list_skills**](docs/BusinessSkillApi.md#list_skills) | **GET** /skills | List all skills
+*Crisphive::BusinessSkillApi* | [**list_skills_by_category**](docs/BusinessSkillApi.md#list_skills_by_category) | **GET** /skill-categories/{id}/skills | List skills in a category
+*Crisphive::CustomerApi* | [**create_customer**](docs/CustomerApi.md#create_customer) | **POST** /customers | Create a customer
+*Crisphive::CustomerApi* | [**delete_customer**](docs/CustomerApi.md#delete_customer) | **DELETE** /customers/{id} | Delete a customer
+*Crisphive::CustomerApi* | [**get_customer**](docs/CustomerApi.md#get_customer) | **GET** /customers/{id} | Get a customer
+*Crisphive::CustomerApi* | [**list_customers**](docs/CustomerApi.md#list_customers) | **GET** /customers | List customers
+*Crisphive::CustomerApi* | [**update_customer**](docs/CustomerApi.md#update_customer) | **PUT** /customers/{id} | Update a customer
+*Crisphive::JobRequestBusinessApi* | [**create_job_request**](docs/JobRequestBusinessApi.md#create_job_request) | **POST** /job-requests | Create a job request (business actor)
+*Crisphive::JobRequestBusinessApi* | [**get_job_request**](docs/JobRequestBusinessApi.md#get_job_request) | **GET** /job-requests/{id} | Get a job request
+*Crisphive::JobRequestBusinessApi* | [**get_job_request_timeline**](docs/JobRequestBusinessApi.md#get_job_request_timeline) | **GET** /job-requests/{id}/timeline | Job timeline (business surface — also serves tech via BusinessAuth)
+*Crisphive::JobRequestBusinessApi* | [**list_job_request_booking_windows**](docs/JobRequestBusinessApi.md#list_job_request_booking_windows) | **GET** /job-requests/booking-windows | Booking availability (business actor)
+*Crisphive::JobRequestBusinessApi* | [**list_job_request_changes**](docs/JobRequestBusinessApi.md#list_job_request_changes) | **GET** /job-requests/changes | Poll for new & changed job requests (sync feed)
+*Crisphive::JobRequestBusinessApi* | [**list_job_requests**](docs/JobRequestBusinessApi.md#list_job_requests) | **GET** /job-requests | List job requests
+*Crisphive::JobTypesApi* | [**get_job_type**](docs/JobTypesApi.md#get_job_type) | **GET** /job-types/{id} | Get a job type
+*Crisphive::JobTypesApi* | [**list_job_types**](docs/JobTypesApi.md#list_job_types) | **GET** /job-types | List job types
+*Crisphive::ServiceAreaApi* | [**get_service_area**](docs/ServiceAreaApi.md#get_service_area) | **GET** /service-areas/{id} | Get a service area
+*Crisphive::ServiceAreaApi* | [**list_service_areas**](docs/ServiceAreaApi.md#list_service_areas) | **GET** /service-areas | List service areas
+*Crisphive::TechnicianApi* | [**get_technician**](docs/TechnicianApi.md#get_technician) | **GET** /technicians/{id} | Get a technician
+*Crisphive::TechnicianApi* | [**list_technicians**](docs/TechnicianApi.md#list_technicians) | **GET** /technicians | List technicians
+*Crisphive::VehicleApi* | [**get_vehicle**](docs/VehicleApi.md#get_vehicle) | **GET** /vehicles/{id} | Get a vehicle
+*Crisphive::VehicleApi* | [**list_vehicles**](docs/VehicleApi.md#list_vehicles) | **GET** /vehicles | List vehicles
+
+
+## Documentation for Models
+
+ - [Crisphive::CreateCustomer200Response](docs/CreateCustomer200Response.md)
+ - [Crisphive::CreateJobRequest200Response](docs/CreateJobRequest200Response.md)
+ - [Crisphive::Customer](docs/Customer.md)
+ - [Crisphive::CustomerAddress](docs/CustomerAddress.md)
+ - [Crisphive::CustomerAddressRequest](docs/CustomerAddressRequest.md)
+ - [Crisphive::CustomerContact](docs/CustomerContact.md)
+ - [Crisphive::CustomerCreateRequest](docs/CustomerCreateRequest.md)
+ - [Crisphive::CustomerCreateResponse](docs/CustomerCreateResponse.md)
+ - [Crisphive::CustomerList](docs/CustomerList.md)
+ - [Crisphive::CustomerListItem](docs/CustomerListItem.md)
+ - [Crisphive::CustomerProfile](docs/CustomerProfile.md)
+ - [Crisphive::CustomerSpending](docs/CustomerSpending.md)
+ - [Crisphive::CustomerTierProgress](docs/CustomerTierProgress.md)
+ - [Crisphive::CustomerUpdateRequest](docs/CustomerUpdateRequest.md)
+ - [Crisphive::GetCustomer200Response](docs/GetCustomer200Response.md)
+ - [Crisphive::GetJobRequest200Response](docs/GetJobRequest200Response.md)
+ - [Crisphive::GetJobRequestTimeline200Response](docs/GetJobRequestTimeline200Response.md)
+ - [Crisphive::GetJobType200Response](docs/GetJobType200Response.md)
+ - [Crisphive::GetServiceArea200Response](docs/GetServiceArea200Response.md)
+ - [Crisphive::GetTechnician200Response](docs/GetTechnician200Response.md)
+ - [Crisphive::GetVehicle200Response](docs/GetVehicle200Response.md)
+ - [Crisphive::JobDate](docs/JobDate.md)
+ - [Crisphive::JobDateBusinessRange](docs/JobDateBusinessRange.md)
+ - [Crisphive::JobDatePeriod](docs/JobDatePeriod.md)
+ - [Crisphive::JobDatePeriodEntry](docs/JobDatePeriodEntry.md)
+ - [Crisphive::JobRequest](docs/JobRequest.md)
+ - [Crisphive::JobRequestActionAuditBy](docs/JobRequestActionAuditBy.md)
+ - [Crisphive::JobRequestActionAuditEntry](docs/JobRequestActionAuditEntry.md)
+ - [Crisphive::JobRequestActionSummary](docs/JobRequestActionSummary.md)
+ - [Crisphive::JobRequestAddressSummary](docs/JobRequestAddressSummary.md)
+ - [Crisphive::JobRequestArchiveSummary](docs/JobRequestArchiveSummary.md)
+ - [Crisphive::JobRequestArrivalWindow](docs/JobRequestArrivalWindow.md)
+ - [Crisphive::JobRequestAssignedVehicle](docs/JobRequestAssignedVehicle.md)
+ - [Crisphive::JobRequestAssignmentSummary](docs/JobRequestAssignmentSummary.md)
+ - [Crisphive::JobRequestBookingWindows](docs/JobRequestBookingWindows.md)
+ - [Crisphive::JobRequestBusinessTimeRange](docs/JobRequestBusinessTimeRange.md)
+ - [Crisphive::JobRequestChanges](docs/JobRequestChanges.md)
+ - [Crisphive::JobRequestCreateRequest](docs/JobRequestCreateRequest.md)
+ - [Crisphive::JobRequestCreateResponse](docs/JobRequestCreateResponse.md)
+ - [Crisphive::JobRequestCrewMember](docs/JobRequestCrewMember.md)
+ - [Crisphive::JobRequestCustomerSummary](docs/JobRequestCustomerSummary.md)
+ - [Crisphive::JobRequestDayWindows](docs/JobRequestDayWindows.md)
+ - [Crisphive::JobRequestJobDateBusinessRangeRequest](docs/JobRequestJobDateBusinessRangeRequest.md)
+ - [Crisphive::JobRequestJobDatePeriodRequest](docs/JobRequestJobDatePeriodRequest.md)
+ - [Crisphive::JobRequestJobDateRequest](docs/JobRequestJobDateRequest.md)
+ - [Crisphive::JobRequestList](docs/JobRequestList.md)
+ - [Crisphive::JobRequestPeriod](docs/JobRequestPeriod.md)
+ - [Crisphive::JobRequestQuoteSummary](docs/JobRequestQuoteSummary.md)
+ - [Crisphive::JobRequestRatingSummary](docs/JobRequestRatingSummary.md)
+ - [Crisphive::JobRequestSchedule](docs/JobRequestSchedule.md)
+ - [Crisphive::JobRequestSession](docs/JobRequestSession.md)
+ - [Crisphive::JobRequestSkillSummary](docs/JobRequestSkillSummary.md)
+ - [Crisphive::JobRequestStatusSummary](docs/JobRequestStatusSummary.md)
+ - [Crisphive::JobRequestTechnicianInfo](docs/JobRequestTechnicianInfo.md)
+ - [Crisphive::JobRequestTimeline](docs/JobRequestTimeline.md)
+ - [Crisphive::JobRequestTimelineAction](docs/JobRequestTimelineAction.md)
+ - [Crisphive::JobRequestTimelineEvent](docs/JobRequestTimelineEvent.md)
+ - [Crisphive::JobType](docs/JobType.md)
+ - [Crisphive::ListCustomers200Response](docs/ListCustomers200Response.md)
+ - [Crisphive::ListJobRequestBookingWindows200Response](docs/ListJobRequestBookingWindows200Response.md)
+ - [Crisphive::ListJobRequestChanges200Response](docs/ListJobRequestChanges200Response.md)
+ - [Crisphive::ListJobRequests200Response](docs/ListJobRequests200Response.md)
+ - [Crisphive::ListJobTypes200Response](docs/ListJobTypes200Response.md)
+ - [Crisphive::ListServiceAreas200Response](docs/ListServiceAreas200Response.md)
+ - [Crisphive::ListSkillCategories200Response](docs/ListSkillCategories200Response.md)
+ - [Crisphive::ListSkills200Response](docs/ListSkills200Response.md)
+ - [Crisphive::ListSkillsByCategory200Response](docs/ListSkillsByCategory200Response.md)
+ - [Crisphive::ListTechnicians200Response](docs/ListTechnicians200Response.md)
+ - [Crisphive::ListVehicles200Response](docs/ListVehicles200Response.md)
+ - [Crisphive::Pagination](docs/Pagination.md)
+ - [Crisphive::ResponseEnvelope](docs/ResponseEnvelope.md)
+ - [Crisphive::ServiceArea](docs/ServiceArea.md)
+ - [Crisphive::ServiceAreaList](docs/ServiceAreaList.md)
+ - [Crisphive::Skill](docs/Skill.md)
+ - [Crisphive::SkillByCategoryList](docs/SkillByCategoryList.md)
+ - [Crisphive::SkillCategory](docs/SkillCategory.md)
+ - [Crisphive::SkillCategoryList](docs/SkillCategoryList.md)
+ - [Crisphive::SkillList](docs/SkillList.md)
+ - [Crisphive::SkillSummary](docs/SkillSummary.md)
+ - [Crisphive::Technician](docs/Technician.md)
+ - [Crisphive::TechnicianAddress](docs/TechnicianAddress.md)
+ - [Crisphive::TechnicianLeadRef](docs/TechnicianLeadRef.md)
+ - [Crisphive::TechnicianList](docs/TechnicianList.md)
+ - [Crisphive::TechnicianServiceAreaRef](docs/TechnicianServiceAreaRef.md)
+ - [Crisphive::TechnicianStatus](docs/TechnicianStatus.md)
+ - [Crisphive::Vehicle](docs/Vehicle.md)
+ - [Crisphive::VehicleList](docs/VehicleList.md)
+ - [Crisphive::VehicleOwner](docs/VehicleOwner.md)
+
+
+## Documentation for Authorization
+
+
+Authentication schemes defined for the API:
+### ApiKeyAuth
+
+- **Type**: Bearer authentication (CrispHive secret key)
+

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+
+begin
+  require 'rspec/core/rake_task'
+
+  RSpec::Core::RakeTask.new(:spec)
+  task default: :spec
+rescue LoadError
+  # no rspec available
+end

data/crisphive.gemspec

@@ -0,0 +1,40 @@
+# -*- encoding: utf-8 -*-
+
+=begin
+#CrispHive Developer API
+
+#Public REST API for integrating CrispHive from your own backend. Authenticate every request with a secret API key as a Bearer token (`Authorization: Bearer chsk_live_…`). The key prefix selects the data environment: `chsk_live_…` → production (live), `chsk_test_…` → sandbox (isolated test).  **Key scopes (restricted keys).** A key is either *full-access* (can call every endpoint below) or *restricted* to a set of permission codes chosen at creation — the same codes as the dashboard permission grid (e.g. `customers_view`, `job_create`, `team_manage`). A restricted key calling an endpoint outside its scope gets `403`. The full code list is the permission catalog (`GET /permission/modules` on the dashboard API). Create, scope, and revoke keys from the business dashboard.  Every response is wrapped in the envelope `{ \"error_code\": 0, \"message\": \"Success\", \"data\": <payload> }`.
+
+The version of the OpenAPI document: 1.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.11.0
+
+=end
+
+$:.push File.expand_path("../lib", __FILE__)
+require "crisphive/version"
+
+Gem::Specification.new do |s|
+  s.name        = "crisphive"
+  s.version     = Crisphive::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["CrispHive"]
+  s.email       = ["developer@crisphive.com"]
+  s.homepage    = "https://docs.crisphive.com"
+  s.summary     = "Official Ruby SDK for the CrispHive API"
+  s.description = "Official Ruby SDK for the CrispHive API. Typed access to the public /v1 API - customers, bookings, catalog, team and fleet."
+  s.license     = "MIT"
+  s.required_ruby_version = ">= 2.7"
+  s.metadata    = { "source_code_uri" => "https://github.com/crisphive/crisphive-ruby", "documentation_uri" => "https://docs.crisphive.com" }
+
+  s.add_runtime_dependency 'faraday', '>= 1.0.1', '< 3.0'
+  s.add_runtime_dependency 'faraday-multipart'
+  s.add_runtime_dependency 'marcel'
+
+  s.add_development_dependency 'rspec', '~> 3.6', '>= 3.6.0'
+
+  s.files         = `find *`.split("\n").uniq.sort.select { |f| !f.empty? }
+  s.executables   = []
+  s.require_paths = ["lib"]
+end

data/git_push.sh

@@ -0,0 +1,57 @@
+#!/bin/sh
+# ref: https://help.github.com/articles/adding-an-existing-project-to-github-using-the-command-line/
+#
+# Usage example: /bin/sh ./git_push.sh wing328 openapi-petstore-perl "minor update" "gitlab.com"
+
+git_user_id=$1
+git_repo_id=$2
+release_note=$3
+git_host=$4
+
+if [ "$git_host" = "" ]; then
+    git_host="github.com"
+    echo "[INFO] No command line input provided. Set \$git_host to $git_host"
+fi
+
+if [ "$git_user_id" = "" ]; then
+    git_user_id="crisphive"
+    echo "[INFO] No command line input provided. Set \$git_user_id to $git_user_id"
+fi
+
+if [ "$git_repo_id" = "" ]; then
+    git_repo_id="crisphive-ruby"
+    echo "[INFO] No command line input provided. Set \$git_repo_id to $git_repo_id"
+fi
+
+if [ "$release_note" = "" ]; then
+    release_note="Minor update"
+    echo "[INFO] No command line input provided. Set \$release_note to $release_note"
+fi
+
+# Initialize the local directory as a Git repository
+git init
+
+# Adds the files in the local repository and stages them for commit.
+git add .
+
+# Commits the tracked changes and prepares them to be pushed to a remote repository.
+git commit -m "$release_note"
+
+# Sets the new remote
+git_remote=$(git remote)
+if [ "$git_remote" = "" ]; then # git remote not defined
+
+    if [ "$GIT_TOKEN" = "" ]; then
+        echo "[INFO] \$GIT_TOKEN (environment variable) is not set. Using the git credential in your environment."
+        git remote add origin https://${git_host}/${git_user_id}/${git_repo_id}.git
+    else
+        git remote add origin https://${git_user_id}:"${GIT_TOKEN}"@${git_host}/${git_user_id}/${git_repo_id}.git
+    fi
+
+fi
+
+git pull origin master
+
+# Pushes (Forces) the changes in the local repository up to the remote repository
+echo "Git pushing to https://${git_host}/${git_user_id}/${git_repo_id}.git"
+git push origin master 2>&1 | grep -v 'To https'

data/lib/crisphive/api/business_skill_api.rb

@@ -0,0 +1,211 @@
+=begin
+#CrispHive Developer API
+
+#Public REST API for integrating CrispHive from your own backend. Authenticate every request with a secret API key as a Bearer token (`Authorization: Bearer chsk_live_…`). The key prefix selects the data environment: `chsk_live_…` → production (live), `chsk_test_…` → sandbox (isolated test).  **Key scopes (restricted keys).** A key is either *full-access* (can call every endpoint below) or *restricted* to a set of permission codes chosen at creation — the same codes as the dashboard permission grid (e.g. `customers_view`, `job_create`, `team_manage`). A restricted key calling an endpoint outside its scope gets `403`. The full code list is the permission catalog (`GET /permission/modules` on the dashboard API). Create, scope, and revoke keys from the business dashboard.  Every response is wrapped in the envelope `{ \"error_code\": 0, \"message\": \"Success\", \"data\": <payload> }`.
+
+The version of the OpenAPI document: 1.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.11.0
+
+=end
+
+require 'cgi'
+
+module Crisphive
+  class BusinessSkillApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # List skill categories
+    # Returns paginated skill categories for the current business, ordered alphabetically.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :page Page number (default: 1)
+    # @option opts [Integer] :limit Page size (default: 15, max: 1000)
+    # @return [ListSkillCategories200Response]
+    def list_skill_categories(opts = {})
+      data, _status_code, _headers = list_skill_categories_with_http_info(opts)
+      data
+    end
+
+    # List skill categories
+    # Returns paginated skill categories for the current business, ordered alphabetically.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :page Page number (default: 1)
+    # @option opts [Integer] :limit Page size (default: 15, max: 1000)
+    # @return [Array<(ListSkillCategories200Response, Integer, Hash)>] ListSkillCategories200Response data, response status code and response headers
+    def list_skill_categories_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BusinessSkillApi.list_skill_categories ...'
+      end
+      # resource path
+      local_var_path = '/skill-categories'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ListSkillCategories200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"BusinessSkillApi.list_skill_categories",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BusinessSkillApi#list_skill_categories\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List all skills
+    # Returns the flat list of all active skills for the current business across every category. Use this to discover the skill UUIDs accepted in `skill_ids` when creating a job request. (For a category-grouped view, use GET /skill-categories and GET /skill-categories/{id}/skills.)
+    # @param [Hash] opts the optional parameters
+    # @return [ListSkills200Response]
+    def list_skills(opts = {})
+      data, _status_code, _headers = list_skills_with_http_info(opts)
+      data
+    end
+
+    # List all skills
+    # Returns the flat list of all active skills for the current business across every category. Use this to discover the skill UUIDs accepted in &#x60;skill_ids&#x60; when creating a job request. (For a category-grouped view, use GET /skill-categories and GET /skill-categories/{id}/skills.)
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ListSkills200Response, Integer, Hash)>] ListSkills200Response data, response status code and response headers
+    def list_skills_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BusinessSkillApi.list_skills ...'
+      end
+      # resource path
+      local_var_path = '/skills'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ListSkills200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"BusinessSkillApi.list_skills",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BusinessSkillApi#list_skills\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List skills in a category
+    # Returns paginated skills belonging to the given category, ordered alphabetically. The `members` field on each skill is the count of active technicians currently assigned to it.
+    # @param id [String] Skill category ID (UUID)
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :page Page number (default: 1)
+    # @option opts [Integer] :limit Page size (default: 15, max: 1000)
+    # @return [ListSkillsByCategory200Response]
+    def list_skills_by_category(id, opts = {})
+      data, _status_code, _headers = list_skills_by_category_with_http_info(id, opts)
+      data
+    end
+
+    # List skills in a category
+    # Returns paginated skills belonging to the given category, ordered alphabetically. The &#x60;members&#x60; field on each skill is the count of active technicians currently assigned to it.
+    # @param id [String] Skill category ID (UUID)
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :page Page number (default: 1)
+    # @option opts [Integer] :limit Page size (default: 15, max: 1000)
+    # @return [Array<(ListSkillsByCategory200Response, Integer, Hash)>] ListSkillsByCategory200Response data, response status code and response headers
+    def list_skills_by_category_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BusinessSkillApi.list_skills_by_category ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling BusinessSkillApi.list_skills_by_category"
+      end
+      # resource path
+      local_var_path = '/skill-categories/{id}/skills'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ListSkillsByCategory200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"BusinessSkillApi.list_skills_by_category",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BusinessSkillApi#list_skills_by_category\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end