---
title: Add or Remove Passes
slug: jetstream-v2/add-or-remove-passes
docTags:
createdAt: 2024-01-23T15:32:30.576Z
---
## About
Add passes to and/or delete passes from the access control list of the specified device.
| **Command Type** | **Device is Online** | **Device is Offline** |
| ---------------------- | ------------------------------------------------------------ | ----------------------------------- |
| Synchronous, Queueable | Immediate execution, Immediate results and published results | Queued execution, Published results |
Applicable to the following device(s): [RFID Enclosures (Cabinets, Fridges, Freezers)](docId\:kobLJQncO2S0-1ozNf09G)
## Parameters
| **Property** | **Location** | **Details** |
| -------------------------------------------------------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **AccessKey**
:::BlockQuote
string
Required
Unique
::: | Header | The access key for your user account.
This value is a 36-character GUID provided during [user account sign up](https://jetstreamrfid.com/login/signup). |
| **DeviceName**
:::BlockQuote
string
Required
Unique
::: | URL | The name of the device.
This value has a max length of 128 ASCII characters.
This value must adhere to this regular expression: ^\[a-zA-Z0-9-\_]\*$ |
| **Add**
:::BlockQuote
array(strings)
Required
::: | Body | The pass(es) to add to the access control list of the device.
Each value must adhere to this regular expression: ^\[A-F0-9]\{10}$
This property is required and must be included with all requests. If there are no passes to add, define an empty array. |
| **Remove**
:::BlockQuote
array(strings)
Required
::: | Body | The pass(es) to delete from the access control list of the device.
Each value must adhere to this regular expression: ^\[A-F0-9]\{10}$
This property is required and must be included with all requests. If there are no passes to delete, define an empty array. |
## Example
### Request URL
**POST** https\://api.jetstreamrfid.com/2/devices/\{Device Name}/accesscontrol
### Request Body
:::BlockQuote
\{
"Add": \["MyPassNumber"],
"Remove": \[]
}
:::
### Response Code
200 OK
### Response Body
:::BlockQuote
\{
"CommandId": " fbfe6dbd-d03a-42ac-8216-2396de99c315",
"Status": "Completed",
"ExceptionList": \[],
"OutputParameterList": \[]
}
:::
### Published CommandQueuedEvent
:::BlockQuote
\{
"Device": "MyDeviceName",
"CommandId": "fbfe6dbd-d03a-42ac-8216-2396de99c315",
"CommandName": "UpdatePasses",
"URI": "/2/Devices/MyDeviceName/AccessControl",
"Verb": "Post",
"User": "MyUserName",
"Parameters": \[
\{
"Key": "Add",
"Value": "MyPassNumber"
}
],
"Type": "CommandQueuedEvent",
"EventId": "ff47841c-6ecd-471f-85ec-46dfc708efc4",
"EventTime": "2017-05-17T13:51:08Z"
}
:::
### Published CommandCompletionEvent
:::BlockQuote
\{
"CommandId": "fbfe6dbd-d03a-42ac-8216-2396de99c315",
"CommandName": "UpdatePasses",
"OutputParameterList": \[],
"ExceptionList": \[],
"Device": "MyDeviceName",
"ReceivedTime": "2017-05-17T13:51:24Z",
"Type": "CommandCompletionEvent",
"EventId": "56ae62b2-01c7-4ac3-a5c1-c49849291f3f",
"EventTime": "2017-05-17T13:51:18Z"
}
:::
## Version Changes
Replaces UpdatePasses