NOTICE: This repository has been moved to https://code.adriano.fyi/me/kombo-ruby-sdk. Microsoft has shown little interest in stewarding what was once the best and largest open source community. This small act of migration is my way showing that we don't all support Microsoft's disinterest.

Kombo.dev Ruby SDK

This is a Ruby SDK from Kombo's OpenAPI spec.

Generate SDK

The SDK is generated from OpenAPI specifications.

This repo uses a nix devenv to generate code. With direnv installed, run direnv allow inside of this repository directory to enable the devenv.

When kombo changes their OpenAPI spec, this SDK can be updated by running generate-sdk inside the devenv.

Usage

First, create a kombo API key and place it in an environment variable named KOMBO_API_KEY.

Create a client

config = Kombo.configure do |c|
  # As far as we can tell, this value is not currently used
  c.api_key = ENV['KOMBO_API_KEYY']
  # The access token is used in as the Bearer token when making requests to kombo's API; it's not clear why the
  # OpenAPI SDK generator doesn't use `api_key`, so for now, we are setting both until the difference between api_key
  # and access_token is sorted out in the SDK generator. This might be an oddity in Komobo's upstream OpenAPI spec.
  c.access_token = ENV['KOMBO_API_KEY']
  c.host = 'api.us.kombo.dev' # Use api.eu.kombo.dev for instances in the EU; the default value of api.kombo.dev does not work
  c
end
client = Kombo::ApiClient.new(config)

Example: Get a HRIS API instance

hris = Kombo::UnifiedHRISAPIApi.new(client)

Example: Get all employees using the unified HRIS API

hris.get_hris_employees('<INTEGRATION ID>')