ruby-jss

ruby-jss  is a Ruby Software Development Kit for interacting with Jamf Pro's REST APIs.

Commonly used API objects are abstracted as Ruby classes, providing a simple interface for creating, retrieving, modifiying, or deleting them.

When using ruby-jss, you don't have to worry about the details like connection headers, bearer tokens, parsing or formatting XML or JSON, GET vs PUT vs POST, the URL paths for related API items, and so on. You don't even need to think about which API is being used.

All of that is handled 'under the hood' for you. You can focus on the objects in your Jamf Pro server - the computers, devices, groups, policies, packages, profiles, etc, and their properties and actions. Your code will reflect them and their attributes at a conceptual level, increasing writability, readability, and maintainability.

Not only can you easily write automations and other tools to interact with you Jamf Pro server, when used in Interactive Ruby ('irb') ruby-jss can be used as a live, realtime 'shell' for performing on-the-fly tasks.

Of course, if desired, there are lower-level methods to access API endpoints directly, allowing you to work with their raw data, giving you even more flexibility.

If you're new to ruby or the API, feel free to reach out in the MacAdmins Slack Channels #ruby-jss,  #ruby or #jamf-api or directly with the primary developer (if he's on line).