---
title: Set Configuration Values for a Device
slug: jetstream-v3/set-configuration-values-for-a-device
docTags: 
createdAt: 2024-02-27T14:27:19.307Z
---

## About

Queue a Set Config Values command to a specified device for specified parameters. This endpoint allows you to update a limited set of configuration values for your device without having to set all parameters for the device's policy. If a policy is added to the selected device after the Set Config Values command is queued, the policy settings will apply to the device and overwrite the Set Config Values parameters set.&#x20;

| **Command Type**       | **Device is Online**                                         | **Device is Offline**               |
| ---------------------- | ------------------------------------------------------------ | ----------------------------------- |
| Synchronous, Queueable | Immediate execution, Immediate results and Published results | Queued execution, Published results |

## Parameters

| **Property**                                                                   | **Location** | **Details**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------------------------------------------------------------ | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **AccessKey**<br />:::BlockQuote
string&#xA;Required&#xA;Unique
:::            | Header       | The access key for your user account.<br />This value is a 36-character GUID provided in your [user profile](docId\:BbIFQiuIXND5iAfMreBBi).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **DeviceName**<br />:::BlockQuote
string&#xA;Required&#xA;Unique
:::           | URL          | The name of the device.<br />This value has a max length of 128 ASCII characters.<br />This value must adhere to this regular expression: ^\[a-zA-Z0-9-\_,. ]\*$                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **ConfigValues**<br />:::BlockQuote
dictionary(string,string)&#xA;Required
::: | Request Body | The configuration parameters and values to be applied to the device.<br />All values defined must be of the type (e.g., int, bool, string, float, datetime) defined in the associated device definition.<br />See the [Device Types](docId:0MDmV9MhEyzOdrEra8n7x) page for your device for additional information for each config value. <br />**Available ConfigValues**<br />antennarxsensitivity<br />antenna1rxsensitivity<br />antenna2rxsensitivity<br />antenna3rxsensitivity<br />antenna4rxsensitivity<br />antennatxpower<br />antenna1txpower<br />antenna2txpower<br />antenna3txpower<br />antenna4txpower<br />dooropentimelimit<br />fieldofview<br />heartbeateventinterval<br />objecteventscantime<br />sensorreadingeventinterval |

## Example

### Request URL

**POST** https\://api.jetstreamrfid.com/3/devices/\{Device Name}/configuration

### Request Body

:::BlockQuote
\{
&#x20; "objecteventscantime": "60",
&#x20; "sensorreadingeventinterval": "60",
&#x20; "heartbeateventinterval": "60"
}
:::

:::hint{type="info"}
If your request body contains duplicate configuration values, the configuration value that is latest in the list will be applied.&#x20;
:::

### Response Code

200 OK

### Response Body

:::BlockQuote
\{
&#x20; "CommandId": "string",
&#x20; "Status": "Queued",
&#x20; "ExceptionList": \[],
&#x20; "OutputParameterList": \[
&#x20;     \{
&#x20;     "Key": "objecteventscantime",
&#x20;     "Value": "60"
&#x20;   },
&#x20;     \{
&#x20;     "Key": "sensorreadingeventinterval",
&#x20;     "Value": "60"
&#x20;   },
&#x20;     \{
&#x20;     "Key": "heartbeateventinterval",
&#x20;     "Value": "60"
&#x20;   }
&#x20; ]
}
:::

### Published CommandQueuedEvent

:::BlockQuote
\{
&#x20; "Uri": "string",
&#x20; "Type": "CommandQueuedEvent",
&#x20; "User": "string",
&#x20; "Verb": "Post",
&#x20; "Device": "string",
&#x20; "EventId": "string",
&#x20; "Version": 3,
&#x20; "CommandId": "string",
&#x20; "EventTime": "string",
&#x20; "Parameters": \[
&#x20;   \{
&#x20;     "Key": "objecteventscantime",
&#x20;     "Value": "60"
&#x20;   },
&#x20;     \{
&#x20;     "Key": "sensorreadingeventinterval",
&#x20;     "Value": "60"
&#x20;   },
&#x20;     \{
&#x20;     "Key": "heartbeateventinterval",
&#x20;     "Value": "60"
&#x20;   }
&#x20; ],
&#x20; "CommandName": "SetConfigValuesCommand"
}
:::

### Published CommandCompletionEvent

:::BlockQuote
\{
&#x9;"CommandId": "string",
&#x9;"CommandName": "SetConfigValuesCommand",
&#x9;"OutputParameterList": \[
&#x20;     \{
&#x20;     "Key": "objecteventscantime",
&#x20;     "Value": "60"
&#x20;   },
&#x20;     \{
&#x20;     "Key": "sensorreadingeventinterval",
&#x20;     "Value": "60"
&#x20;   },
&#x20;     \{
&#x20;     "Key": "heartbeateventinterval",
&#x20;     "Value": "60"
&#x20;   }
],
&#x9;"ExceptionList": \[],
&#x9;"Device": "string",
&#x9;"ReceivedTime": "string",
&#x9;"Type": "CommandCompletionEvent",
&#x9;"EventId": "string",
&#x9;"EventTime": "string"
&#x9;"Version":3
}
:::

## Version Changes

None – this is a new endpoint.
