---
title: "Upgrade sensor"
source_url: https://dev.digicert.com/certcentral-apis/discovery-api/sensor/upgrade-sensor.html
api_method: POST
api_endpoint: "/apicontroller/v1/sensor/upgradeSensor"
api_url: "https://daas.digicert.com/apicontroller/v1/sensor/upgradeSensor"
---

**POST** `https://daas.digicert.com/apicontroller/v1/sensor/upgradeSensor`

Use this endpoint to upgrade the sensor when a new software update is available.


> **Info**
>
> This success message will only display when the updatePreference is set to `1`. See, [Update sensor details](https://dev.digicert.com/md/certcentral-apis/discovery-api/sensor/update-sensor-details.md).


## Example requests and responses

## cURL

```bash
curl --location --request POST 'https://daas.digicert.com/apicontroller/v1/sensor/upgradeSensor' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{"licenseKey":[{{license_key}}],"accountId":5153184,"divisionIds":[677793]}'
```

## 200 OK

```json
[
    {
        "error": null,
        "data": {
            "id": "B94EDA7F773F19AD",
            "message": "Sensor upgrade Successful"
        }
    }
]
```

## Request parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt.</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>licenseKey</td>
<td>required</td>
<td>string</td>
<td>License key of the sensor to upgrade.</td>
</tr>
<tr>
<td>accountId</td>
<td>required</td>
<td>string</td>
<td>Account ID.</td>
</tr>
<tr>
<td>divisionIds</td>
<td>required</td>
<td>integer</td>
<td>User's division IDs.</td>
</tr>
</tbody>
</table>

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>error</td>
<td>object</td>
<td>Includes the error code, if any.</td>
</tr>
<tr>
<td>data</td>
<td>object</td>
<td>Object container for response.</td>
</tr>
<tr>
<td>.. id</td>
<td>string</td>
<td>License key of the updated sensor.</td>
</tr>
<tr>
<td>.. message</td>
<td>string</td>
<td>Message with additional information about the request.</td>
</tr>
</tbody>
</table>