Jamf School API for Deno

An unofficial, idiomatic API wrapper for Jamf School.
It should be usable by any school IT admin with some experience in JavaScript.

If something doesn’t work as expected or you just want some help, please raise an issue on GitHub so we can improve the library and documentation for everyone!

Currently, only a limited (mostly read-only) 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
• 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.2.0/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

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

// The client can be instantiated with an API instead of credentials.
const api = jamf.createAPI({
  id: "YOUR_NETWORK_ID",
  token: "YOUR_API_TOKEN",
  url: "https://YOUR_SCHOOL.jamfcloud.com/api",
});

const client = jamf.createClient({ api });

// Using the API directly gives you control over exactly what requests
// are made. All the data returned is validated, of course.
const deviceData = await api.getDevices({ ownerName: "Robert" });

// If you have a client, objects can be created from API data directly.
const devices = deviceData.map((data) => client.createDevice(data));

// Everything is promise-based, so you can do things concurrently.
await Promise.allSettled((devices) => device.restart());

Changelog

Each entry only explains what changed, but links to a pull request that explains why.

Version 0.2.0

• Breaking: Changed how clients are instantiated with an API (#8)
  The API object must now be passed in as an api property on an object.

• Added methods to set device ownership (#10, #16)
  API.assignDeviceOwner and Device.setOwner. The documentation contains examples.

• Various schema improvements and corrections (#10, #20)
  More data is now included. To the best of my knowledge, the current schemas are complete.

• Schemas don’t fail when additional properties are returned (#19)
  Release builds of schemas are now resilient against additional properties being added, but will still fail if any required properties are omitted.

• Handle authentication errors with a better message (#24)
  Previously, authentication errors were lumped in with other errors, which made them confusing to read.

• Changed how data is validated (#7)
  Technical change, but a good increase in real-world performance.

Version 0.1.0

• Initial release
  Includes basic API support for devices, device groups, users, and user groups, as well as an object-oriented layer to simplify using the API.

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).