Jetstream API
Jetstream Workflow Guides
Configuring a Device: Pass Access
8min
all terso devices of the device type rfid enclosures (cabinets, fridges, freezers) docid\ uxzf6ddof1t2zgzzjh9m6 (which includes all freezers, fridges, and most cabinets) are secured and will only unlock when presented with a valid lf rfid pass we generically refer to lf rfid passes as "credentials" configuring which passes can open which devices with the api takes several sequential steps, but following this guide will ensure that your access configuration goes as smoothly as possible let's review the high level steps to configure an enclosure's credentials list before we dive into the details create a list of pass credentials which can access a particular enclosure sync the credentials to the physical jetstream device verify that the credentials you synced to the device are the only passes which are able to open the cabinet modify as needed creating device credentials enclosure's must be assigned a list of pass credentials in jetstream before that list can then be synced to the device use the create device credentials docid y xfsvux fyloqyuzqmr endpoint, specifying the device name and the list of pass credentials you want to allow to access that device syncing device credentials to a device at this point, jetstream knows which pass credentials are allowed to access the enclosure, but the physical enclosure has not yet received the new list of approved credentials for each device that has device credentials specified in jetstream, use the sync device credentials docid\ l7ik ra1wcy3phhm0fwqs endpoint to apply the credentials as they are configured in jetstream only sync the credentials to a device when the device is online and able to receive the command if the device does not receive the command within 24 hours, the command will time out and the credentials will not be synced you can verify that a device is online using the get device status docid 0r9xzn3hnqid911qs3wxg command, an online device should respond with "websockets enabled" reviewing credentials in jetstream and synced credentials you have created a list of credentials for each secured device in jetstream, and synced the credentials to those device you can review the current state of credentials in jetstream and on the physical device using different endpoints review a specific device's existing credentials list in jetstream using the get device credentials docid\ x1 nubzlpevnels9beq17 endpoint review the last time the jetstream credentials list was synced to a device using the get last device credentials sync date/time docid\ xcfht1rs4l0m0ssfmpz8e endpoint this will allow you to determine if the list in jetstream matches the list on the physical device if the list in jetstream was modified after the last sync time, a sync device credentials docid\ l7ik ra1wcy3phhm0fwqs should be made so that the jetstream list matches the physical device list changing a device's credentials you have successfully created a list of credentials for an enclosure, and synced those credentials to the physical device if you wish to change the credentials that can access a device at this point, you have multiple options, depending on your goal modify device credentials this option is best when you want to add additional credentials, or add and remove credentials simultaneously, to a device overwrite the device's existing credentials list in jetstream using the modify device credentials docid\ j3ncv3riuibv506 jobzd endpoint sync the new credentials list to the device, using the steps above delete specific credentials this option is best if you are only looking to remove specific credentials from a device specify the specific credentials you want removed from the device using the delete device credentials docid 6bj1etryzo paajn3zasg endpoint sync the new, shorter, credentials list to the device, using the steps above delete all credentials this option is best if you wish to quickly remove all credentials from a device, completely preventing anyone from opening the device if you want to remove access to the device only temporarily (less than a week), consider using the lockdown a device docid\ vboyeohcjlpy 7zr afgz endpoint instead use the modify device credentials docid\ j3ncv3riuibv506 jobzd endpoint and pass an empty credentials array to overwrite all passes without having to specify each pass you want to delete sync the new, empty, credentials list to the device, using the steps above