Jamf School API for Deno

An unofficial, idiomatic API wrapper for Jamf School. It’s designed to be easy for IT professionals with JavaScript experience to learn, and to be safe enough to trust in production.

If something doesn’t work as expected or you just want some help, please raise an issue on GitHub. Bad documentation is a bug!

Currently, only a subset of API features are supported.

Here’s the documentation for the latest release.

Features

• Designed for modern JavaScript
• A low-level API wrapper and a higher-level object-oriented interface
• Data validation means you always get the data you’re promised
• Comprehensive documentation and easy-to-follow example
• Only requires --allow-net=YOUR_SCHOOL.jamfcloud.com

Usage

Here’s how to get your API credentials. You’ll have to replace the token, ID, and URL in the examples.

This example will print the name of each registered device.

device_names.ts

import * as jamf from "https://deno.land/x/jamf_school@0.4.1/mod.ts";

const client = jamf.createClient({
  id: "YOUR_NETWORK_ID",
  token: "YOUR_API_TOKEN",
  url: "https://YOUR_SCHOOL.jamfcloud.com/api",
});

// See the docs for everything clients can do.
const devices = await client.getDevices();

for (const device of devices) {
  console.log(device.udid, device.name);
}

Now run that script.

deno run --allow-net=YOUR_SCHOOL.jamfcloud.com device_names.ts

Changelog

Each entry explains what changed and links to a pull request that has more details.

Version 0.4.1

• Added User.restartDevices() (#73)
  Users contain devices, so this makes the API more consistent.

• Fixed DeviceGroup.restartDevices() (#75)
  The documentation claimed that failing to restart devices wouldn’t throw, but it actually did.

Version 0.4.0

• Added methods to edit a User/UserGroup/Device/DeviceGroup (#58, #61, #62)
  Update multiple properties using an API, or more easily with the respective objects’ set methods.

• Added methods to set User/Device locations (#63, #66)
  Move individual users and devices, or move in bulk with Location objects. Search the docs for ‘move’ or ‘location’.

• Added Client.getUserByUsername (#58)
  Usernames are inherently unique, so this makes it a reliable way to fetch users.

• Added locationId & ownerId property to relevant objects (#66)
  Makes it easier to use the objects and allows for better optimization.

• Added DeviceGroup.restartDevices() & Location.restartDevices() (#70)
  These methods make simple restart-scripts much easier to write, but they don’t provide detailed results (failure to restart will not result in an exception).

• Renamed API.assignDeviceOwner (#58)
  Now it’s more consistent: API.setDeviceOwner

• Relaxed signature of Client.getDevicesInGroups (#58)
  The only property of the DeviceGroup objects used was id, and this update is aiming to make this style general.

• Improved how objects are displayed in the console (#60)
  console.log(someDevices) no longer results in Device {}! Indentation doesn’t work properly due to some internal Deno stuff.

• Breaking: Methods that returned Promise<this> now return Promise<void> (#68)
  Returning this is unexpected and encourages worse code than returning nothing at all.

License and Disclaimer

JAMF is a trademark beloning to JAMF Software, LLC. This project’s development is not affiliated with JAMF Software, LLC.

There is a copy of the project’s license (MIT) located in the root of the repository and in the module entrypoint (mod.ts).