# Set a bounded agent-facing preference.

Source: <https://everruns.com/docs/api/operations/set_preference/>

PUT

/v1/virtual-users/{identity\_id}/preferences/{key}

Select code samplecURL (shell:curl)

```js
const url = 'https://app.everruns.com/api/v1/virtual-users/example/preferences/example';
const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json'},
  body: '{"value":{}}'
};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```sh
curl --request PUT \
  --url https://app.everruns.com/api/v1/virtual-users/example/preferences/example \
  --header 'Content-Type: application/json' \
  --data '{ "value": {} }'
```

* Production APIapp.everruns.com/api/v1/virtual-users/{identity\_id}/preferences/{key}

## Parameters

### Path Parameters

**identity\_id**

required

string

**key**

required

string

## Request Bodyrequired

Media typeapplication/json

Request body for setting a preference value.

object

**value**

required

object

##### Examplegenerated

```json
{
  "value": {}
}
```

## Responses

### 200

Success

Media typeapplication/json

##### Examplegenerated

```json
example
```

### 401

Authentication required

### 403

Permission denied