# /set

{% hint style="info" %}
This endpoint requires a POST request!
{% endhint %}

### Endpoint Headers:

* apikey - Your Api Auth Key <mark style="color:orange;">**\[String]**</mark> (<mark style="color:red;">**Required**</mark>)

### Endpoint Body Parameters:

* name - Name of the variable to set <mark style="color:orange;">**\[String]**</mark> (<mark style="color:red;">**Required**</mark>)
* value - Value of the variable to set <mark style="color:orange;">**\[String | Array | Object]**</mark> (<mark style="color:red;">**Required**</mark>)

### Examples:

{% hint style="info" %}
Data API version required. Must replace `<version>` with either **release** or **beta**.
{% endhint %}

<details>

<summary>Bot Designer for Discord</summary>

Example usage of `/db/set` endpoint using BDFD

<pre class="language-bash"><code class="lang-bash">$httpAddHeader[apikey;&#x3C;YOUR-API-KEY>]
$httpPost[https://bdfddata.rickyjs.xyz/&#x3C;version>/db/set;{
<strong>"name": "variable-name", 
</strong>"value": "variable-value"
}]

$httpResult OR $httpResult[entries]
</code></pre>

</details>

<details>

<summary>Discord.js</summary>

Example usage of `/db/set` endpoint using Discord.js

```javascript
const axios = require('axios');
(async () => {
return await axios.post('https://bdfddata.rickyjs.xyz/<version>/db/set', {
"name": "variable-name",
"value": "variable-value"
},
{
headers: {
"apikey": "<YOUR-API-KEY>"
}
}).then(res=>res.data)
})()
```

</details>

### Possible Responses (Codes)

<details>

<summary>Code 200</summary>

API succeeded and details were fetched.

```javascript
{
 status: 200,
 entries: // returns the value of the new or edited variable
 }   
```

</details>

<details>

<summary>Code 400</summary>

An error occurred that stopped execution.

```javascript
{
    status: 400
    error: 'Cannot read ...  (This can vary)'
}
```

</details>

<details>

<summary>Code 424</summary>

Origin Database Unavailable

```javascript
  status: 424,
  error: 'An error occurred while contacting our Database. Please contact the BDFDDaya API Support Team if this issue persists.'
}
```

</details>