---
title: Set a Device's Policy Parameters
slug: jetstream-v3/set-a-devices-policy-parameters
docTags: 
createdAt: 2024-01-23T15:35:56.793Z
---

## About

Instruct the specified device to set/sync its configuration parameters and values to user provided parameters and values, which are defined within the Parameters property of the [Add a Policy to a Device](docId:8iiNKl-mZ80HPIut5zv2e) request. Complete documentation on a device’s configuration parameters and values can be found on its device types page.

| **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 />string<br />Required<br />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 />string<br />Required<br />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-\_,. ]\*$ |

## Example

### Request URL

**POST** https\://api.jetstreamrfid.com/3/devices/&#x7B;DeviceName}/policy/sync

### Request Body

None Required

### Response Code

200 OK

### Response Body

:::BlockQuote
\{
&#x20; "Id": 0,
&#x20; "Name": "Voyc00PsAI",
&#x20; "Parameters": \{
&#x20;   "additionalProp1": "string",
&#x20;   "additionalProp2": "string",
&#x20;   "additionalProp3": "string"
&#x20; },
&#x20; "LastPolicyUpdate": "2024-03-07T22:04:31.121Z",
&#x20; "LastPolicySync": "2024-03-07T22:04:31.121Z"
}
:::

### Published CommandQueuedEvent

:::BlockQuote
\{
&#x9;"Device": "MyDeviceName",
&#x9;"CommandId": "2bf00848-b06a-4820-86fc-58c12e08ee3e",
&#x9;"CommandName": "SetConfigValuesCommand",
&#x9;"URI": "/3/Devices/MyDeviceName/policy/sync",
&#x9;"Verb": "Post",
&#x9;"User": "MyUserName",
&#x9;"Parameters": \[
&#x9;	\{
&#x9;		"Key": "aggregateeventscancount",
&#x9;		"Value": "4"
&#x9;	}
&#x9;],
&#x9;"Type": "CommandQueuedEvent",
&#x9;"EventId": "f3df515b-c53a-4b3b-b3e9-01ffe6ffd8f3",
&#x9;"EventTime": "2018-05-19T01:16:21Z",
&#x9;"Version":3
}
:::

### Published CommandCompletionEvent

:::BlockQuote
\{
&#x9;"CommandId": "2bf00848-b06a-4820-86fc-58c12e08ee3e",
&#x9;"CommandName": "SetConfigValuesCommand",
&#x9;"OutputParameterList": \[],
&#x9;"ExceptionList": \[],
&#x9;"Device": "MyDeviceName",
&#x9;"ReceivedTime": "2018-05-19T01:16:23Z",
&#x9;"Type": "CommandCompletionEvent",
&#x9;"EventId": "93723c89-cb44-44f0-8d86-87ede0fb3ba6",
&#x9;"EventTime": "2018-05-19T01:16:19Z"
&#x9;"Version":2
}
:::

## Version Changes

Added Version Property to Events.
