---
title: "Update Device Record For Hub Device"
method: PATCH
path: "/hubdevices/{hubDeviceId}/childdevice/{deviceId}"
tags: ["HubDevices"]
---

# Update Device Record For Hub Device

`PATCH /hubdevices/{hubDeviceId}/childdevice/{deviceId}`

## Request

- Base URL: `https://api.smartthings.com/v1`
- URL: `https://api.smartthings.com/v1/hubdevices/{hubDeviceId}/childdevice/{deviceId}`
- Auth: OAuth 2
  - Implicit: `https://auth-global.api.smartthings.com`
  - Scopes: `w:devices:*`, `mobile`
- TypeScript: <https://skmtc.dev/smartthings/apis/smartthings-api/docs/hubdevices/:hubDeviceId/childdevice/:deviceId/patch.ts> (a function with typed inputs; its response is checked against the schema)

Updates a hub device record (Widget Backed)

## Path parameters

- `hubDeviceId` string, ^(?:([0-9a-fA-F]{32})|([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}))$, required
- `deviceId` string, required

## Query parameters

- `forceUpdate` boolean

## Headers

- `Authorization` string, string, required

## Request body

- EdgeDeviceUpdateRequest
  - `driverId` string, required: Unique Identifier of the driver
  - `deviceIntegrationProfileKey` DeviceIntegrationProfileKey
    - `id` string, uuid: Unique identifier for integration profile.
    - `majorVersion` integer: Major Version of the integration profile
  - `provisioningState` 'PROVISIONED' | 'TYPED' | 'DRIVER_SWITCH' | 'NONFUNCTIONAL': Provisioning type for a widget device

## Response `204`

Successful creation of resource with no-content to return

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too many requests

## Changes

- **2023-11-27** `e8dd260a33ec`: 1 info
  - added the new optional `query` request parameter `forceUpdate`
- **2022-12-19** `adcacfc2749d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smartthings/apis/smartthings-api/changes/hubdevices/:hubDeviceId/childdevice/:deviceId/patch.md)

---

[API](https://skmtc.dev/smartthings/apis/smartthings-api.md) - [All operations](https://skmtc.dev/smartthings/apis/smartthings-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartthings/apis/smartthings-api/revisions/2788a4236800?raw)