Enable device by ID

PUT
https://one.digicert.com/iot/api/v2/device/{{device_id}}/enable

Use this endpoint to enable a disabled device.

To disable a device, use the Disable device by ID endpoint.

Example requests and responses

cURL
curl --request PUT 'https://one.digicert.com/iot/api/v2/device/{{device_id}}/enable' \
--header 'x-api-key: {{api_key}}' \
--header 'content-type: application/json'
200 OK
{
  "id": "64c02969-3890-4da8-a5ef-b574fd72887e",
  "account_id": "1d1ec1ec-6502-11e9-a923-1681be663d3e",
  "division": {
    "id": "fd5faa1e-623a-47a9-831b-b9397c33395f",
    "name": "Mock Division 1"
  },
  "device_identifier": "New Device",
  "device_profile": {
    "id": "a81a431a-be7b-4f2e-8afd-b2778491511f",
    "name": "Device Profile"
  },
  "created": "2020-04-22T07:13:20Z",
  "updated": "2020-10-09T17:44:35Z",
  "status": "ACTIVE",
  "fields": [
    {
      "id": "417c328e-604c-4e94-9112-ee58f12277fb",
      "name": "Mandatory Field",
      "value": "mandatory value",
      "mandatory": true
    },
    {
      "id": "90eb4de2-ae8a-48a0-a904-d30c5ab6e1de",
      "name": "Optional Field",
      "value": "optional value",
      "mandatory": false
    }
  ],
  "device_api_allow_read": true,
  "device_api_allow_write": true,
  "device_api_allow_renew_certificate": true
}
404 Not Found
{
  "errors": [
    {
      "code": "entity_not_found",
      "message": "Device with ID {{device_id}} does not exist."
    }
  ]
}

Path parameters

Name Req/Opt Description
device_id required The unique ID of the device to enable.
To get a list of devices and their IDs, use the Device list endpoint.

URL query strings

Name Req/Opt Description
division_id required The ID of the division for the device to enable.
To get a list of devices and their division IDs, use the Device list endpoint.

Response parameters

Name Type Description
id string Device ID.
account_id string Account ID.
division object Division container.
.. id string Division ID.
.. name string Division name.
device_identifier string Device name.
device_profile object Device profile container.
.. id string Device profile ID.
.. name string Device profile name.
created string Date and time (UTC) new device was created.
updated string Date and time (UTC) device was last updated.
status string Device status.
Possible values: ACTIVE, DISABLED, DELETED
For a newly enabled device, status is expected to be ACTIVE.
fields array Array of fields that describe device attributes and settings.
.. id string Unique field ID.
.. name string Field name.
.. value string Field value.
.. mandatory boolean Whether or not the field is required, based on the device profile.
device_api_allow_read boolean Whether the device can read its own device information.
This setting applies to calls on the Get device details by ID (client authentication) endpoint that use TLS authentication.
device_api_allow_write boolean Whether the device can update its own device information.
This setting applies to calls on the Update device by ID (client authentication) endpoint that use TLS authentication.
device_api_allow_renew_certificate boolean Whether the device can renew its own certificates.
This setting applies to calls on the Renew device certificate by device ID (client authentication) endpoint that use TLS authentication.