# Tencent Cloud IoT Hub API

> Tencent Cloud IoT Hub API on Apizie: 73 endpoints (Batch Update Firmware, Bind Devices, Cancel Device Firmware Task, Create Device, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/cloud:tencent-iotcloud/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:tencent-iotcloud`
- Category: Cloud
- Status: byok
- Source: https://www.tencentcloud.com/document/api
- Page: https://www.apizie.tech/api/cloud/tencent-iotcloud
- OpenAPI: https://www.apizie.tech/api/cloud/tencent-iotcloud/openapi.json

Tencent Cloud API 3.0 for IoT Hub (iotcloud). Every call is signed with TC3-HMAC-SHA256 using your SecretId and SecretKey.

## Endpoints

### Batch Update Firmware
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/batch-update-firmware` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| FirmwareVersion | string | yes |  |
| FirmwareOriVersion | string | no |  |
| UpgradeMethod | integer | no |  |
| FileName | string | no |  |
| FileMd5 | string | no |  |
| FileSize | integer | no |  |
| DeviceNames | array | no |  |
| TimeoutInterval | integer | no |  |
| Type | integer | no |  |

### Bind Devices
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/bind-devices` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| GatewayProductId | string | yes |  |
| GatewayDeviceName | string | yes |  |
| ProductId | string | yes |  |
| DeviceNames | array | yes |  |
| Skey | string | no |  |

### Cancel Device Firmware Task
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/cancel-device-firmware-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| DeviceName | string | yes |  |
| FirmwareVersion | string | yes |  |
| TaskId | integer | yes |  |

### Create Device
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/create-device` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| DeviceName | string | yes |  |
| Attribute | object | no |  |
| DefinedPsk | string | no |  |
| Isp | integer | no |  |
| Imei | string | no |  |
| LoraDevEui | string | no |  |
| LoraMoteType | integer | no |  |
| Skey | string | no |  |
| LoraAppKey | string | no |  |
| TlsCrt | string | no |  |

### Create Multi Devices Task
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/create-multi-devices-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| ParametersType | string | yes |  |
| FileName | string | no |  |
| FileSize | integer | no |  |
| BatchCount | integer | no |  |
| Hash | string | no |  |

### Create Private CA
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/create-private-ca` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CertName | string | yes |  |
| CertText | string | yes |  |
| VerifyCertText | string | yes |  |

### Create Product
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/create-product` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductName | string | yes |  |
| ProductProperties | object | no |  |
| Skey | string | no |  |

### Create Task File Url
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/create-task-file-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |

### Create Topic Policy
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/create-topic-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| TopicName | string | yes |  |
| Privilege | integer | yes |  |
| BrokerSubscribe | object | no |  |

### Create Topic Rule
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/create-topic-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| RuleName | string | yes |  |
| TopicRulePayload | object | yes |  |

### Delete Device
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/delete-device` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| DeviceName | string | yes |  |
| Skey | string | no |  |

### Delete Device Resource
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/delete-device-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Name | string | yes |  |
| DeviceName | string | yes |  |
| ProductID | string | no |  |

### Delete Device Shadow
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/delete-device-shadow` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| DeviceName | string | yes |  |

### Delete Private CA
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/delete-private-ca` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CertName | string | yes |  |

### Delete Product
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/delete-product` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| Skey | string | no |  |

### Delete Product Private CA
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/delete-product-private-ca` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |

### Delete Topic Rule
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/delete-topic-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| RuleName | string | yes |  |

### Describe Device
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-device` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| DeviceName | string | yes |  |

### Describe Device Client Key
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-device-client-key` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| DeviceName | string | yes |  |

### Describe Device Resource
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-device-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| DeviceName | string | yes |  |
| ProductID | string | no |  |
| Name | string | no |  |

### Describe Device Resources
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-device-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Offset | integer | yes |  |
| Limit | integer | yes |  |
| ProductID | string | no |  |
| DeviceName | string | no |  |
| StartTime | string | no |  |
| EndTime | string | no |  |

### Describe Device Shadow
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-device-shadow` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| DeviceName | string | yes |  |

### Describe Devices
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-devices` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| Offset | integer | yes |  |
| Limit | integer | yes |  |
| FirmwareVersion | string | no |  |
| DeviceName | string | no |  |
| EnableState | integer | no |  |

### Describe Firmware
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-firmware` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| FirmwareVersion | string | yes |  |

### Describe Firmware Task
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-firmware-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| FirmwareVersion | string | yes |  |
| TaskId | integer | yes |  |

### Describe Firmware Task Devices
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-firmware-task-devices` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| FirmwareVersion | string | no |  |
| Filters | array | no |  |
| Offset | integer | no |  |
| Limit | integer | no |  |

### Describe Firmware Task Distribution
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-firmware-task-distribution` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| FirmwareVersion | string | yes |  |
| TaskId | integer | yes |  |

### Describe Firmware Task Statistics
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-firmware-task-statistics` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| FirmwareVersion | string | yes |  |

### Describe Firmware Tasks
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-firmware-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| FirmwareVersion | string | yes |  |
| Offset | integer | yes |  |
| Limit | integer | yes |  |
| Filters | array | no |  |

### Describe Gateway Bind Devices
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-gateway-bind-devices` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| GatewayProductId | string | yes |  |
| GatewayDeviceName | string | yes |  |
| Offset | integer | yes |  |
| Limit | integer | yes |  |
| ProductId | string | no |  |

### Describe Private CA
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-private-ca` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CertName | string | yes |  |

### Describe Private CABinded Products
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-private-cabinded-products` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CertName | string | yes |  |
| Offset | integer | yes |  |
| Limit | integer | yes |  |

### Describe Private CAs
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-private-cas` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |

### Describe Product
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-product` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |

### Describe Product CA
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-product-ca` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |

### Describe Product Resource
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-product-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductID | string | no |  |
| Name | string | no |  |

### Describe Product Resources
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-product-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Offset | integer | yes |  |
| Limit | integer | yes |  |
| ProductID | string | no |  |
| Name | string | no |  |

### Describe Product Task
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-product-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| TaskId | integer | yes |  |

### Describe Product Tasks
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-product-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| Offset | integer | yes |  |
| Limit | integer | yes |  |

### Describe Products
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-products` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Offset | integer | yes |  |
| Limit | integer | yes |  |

### Describe Push Resource Task Statistics
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-push-resource-task-statistics` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductID | string | yes |  |
| Name | string | yes |  |

### Describe Resource Tasks
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/describe-resource-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductID | string | yes |  |
| Name | string | yes |  |
| Offset | integer | yes |  |
| Limit | integer | yes |  |
| Filters | array | no |  |

### Disable Topic Rule
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/disable-topic-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| RuleName | string | yes |  |

### Download Device Resource
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/download-device-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductID | string | yes |  |
| Name | string | yes |  |
| DeviceName | string | yes |  |

### Edit Firmware
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/edit-firmware` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| FirmwareVersion | string | yes |  |
| FirmwareName | string | yes |  |
| FirmwareDescription | string | no |  |
| FirmwareUserDefined | string | no |  |

### Enable Topic Rule
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/enable-topic-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| RuleName | string | yes |  |

### Get All Version
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/get-all-version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |

### Get COSURL
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/get-cosurl` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| FirmwareVersion | string | yes |  |
| FileSize | integer | no |  |

### Get User Resource Info
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/get-user-resource-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |

### List Firmwares
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/list-firmwares` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| PageNum | integer | yes |  |
| PageSize | integer | yes |  |
| ProductId | string | no |  |
| Filters | array | no |  |

### List Log
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/list-log` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| MinTime | integer | yes |  |
| MaxTime | integer | yes |  |
| Keywords | string | no |  |
| Context | string | no |  |
| MaxNum | integer | no |  |

### List Log Payload
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/list-log-payload` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| MinTime | integer | yes |  |
| MaxTime | integer | yes |  |
| Keywords | string | yes |  |
| Context | string | no |  |
| MaxNum | integer | no |  |

### List SDKLog
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/list-sdklog` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| MinTime | integer | yes |  |
| MaxTime | integer | yes |  |
| Keywords | string | yes |  |
| Context | string | no |  |
| MaxNum | integer | no |  |

### List Topic Rules
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/list-topic-rules` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| PageNum | integer | yes |  |
| PageSize | integer | yes |  |

### Publish Broadcast Message
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/publish-broadcast-message` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| Payload | string | yes |  |
| Qos | integer | yes |  |
| PayloadEncoding | string | no |  |

### Publish Message
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/publish-message` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Topic | string | yes |  |
| Payload | string | yes |  |
| ProductId | string | yes |  |
| DeviceName | string | yes |  |
| Qos | integer | no |  |
| PayloadEncoding | string | no |  |

### Publish RRPCMessage
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/publish-rrpcmessage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| DeviceName | string | yes |  |
| Payload | string | yes |  |

### Replace Topic Rule
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/replace-topic-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| RuleName | string | yes |  |
| TopicRulePayload | object | yes |  |

### Reset Device State
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/reset-device-state` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| DeviceNames | array | yes |  |

### Retry Device Firmware Task
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/retry-device-firmware-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| DeviceName | string | yes |  |
| FirmwareVersion | string | yes |  |
| TaskId | integer | yes |  |

### Set Products Forbidden Status
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/set-products-forbidden-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | array | yes |  |
| Status | integer | yes |  |

### Unbind Devices
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/unbind-devices` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| GatewayProductId | string | yes |  |
| GatewayDeviceName | string | yes |  |
| ProductId | string | yes |  |
| DeviceNames | array | yes |  |
| Skey | string | no |  |

### Update Device Available State
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/update-device-available-state` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| DeviceName | string | yes |  |
| EnableState | integer | yes |  |

### Update Device Log Level
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/update-device-log-level` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| DeviceName | string | yes |  |
| LogLevel | integer | yes |  |

### Update Device PSK
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/update-device-psk` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| DeviceName | string | yes |  |
| Psk | string | yes |  |

### Update Device Shadow
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/update-device-shadow` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| DeviceName | string | yes |  |
| State | string | yes |  |
| ShadowVersion | integer | yes |  |

### Update Devices Enable State
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/update-devices-enable-state` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| DeviceNames | array | yes |  |
| Status | integer | yes |  |

### Update Ota Task Status
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/update-ota-task-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| TaskId | integer | yes |  |
| Status | integer | yes |  |

### Update Private CA
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/update-private-ca` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CertName | string | yes |  |
| CertText | string | yes |  |
| VerifyCertText | string | yes |  |

### Update Product Dynamic Register
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/update-product-dynamic-register` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| RegisterType | integer | yes |  |
| RegisterLimit | integer | yes |  |

### Update Product Private CA
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/update-product-private-ca` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| CertName | string | yes |  |

### Update Topic Policy
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/update-topic-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| TopicName | string | yes |  |
| NewTopicName | string | yes |  |
| Privilege | integer | yes |  |
| BrokerSubscribe | object | no |  |

### Upload Firmware
`POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/upload-firmware` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductId | string | yes |  |
| FirmwareVersion | string | yes |  |
| Md5sum | string | yes |  |
| FileSize | integer | yes |  |
| FirmwareName | string | no |  |
| FirmwareDescription | string | no |  |
| FirmwareUserDefined | string | no |  |

## Example
```
curl "https://www.apizie.tech/v1/cloud:tencent-iotcloud/batch-update-firmware" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Tencent Cloud IoT Hub API?
Create a free Apizie key, then send POST https://www.apizie.tech/v1/cloud:tencent-iotcloud/batch-update-firmware with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Tencent Cloud IoT Hub API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Tencent Cloud IoT Hub itself also needs your own key from tencentcloudapi.com.

### Can AI agents use the Tencent Cloud IoT Hub API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:tencent-iotcloud.

### What is the status of the Tencent Cloud IoT Hub API?
Needs your own provider key (bring your own key)