Update Organization Device HMS Read Time

PUT

/openapi/v2.0/manage/api/v1/organizations/{uuid}/manage-devices/hms

Called when user clicks "Mark All as Read" on "Organization Device Health Panel"; marks all HMS events of specified device as read (read time set to current moment). When frontend subsequently pulls HMS list ("Get Organization Device HMS Event List" / "Batch Get Project Device HMS Events" APIs), can use this timestamp as separator to distinguish new from historical events. After successful call, server distributes latest read time to other online terminals in organization (and corresponding projects) via real-time push channel, keeping read status consistent during multi-user collaboration. Authentication: caller must have view permission for target devices in organization; API first validates whether device is bound to organization; devices not directly bound go through "Unbound Device in Organization" fallback validation path (i.e. validates via its gateway device); behavior differs from "Update Project Device HMS Read Time" API (project level only accepts directly bound devices).

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "device_sn": "2TUDK87654321"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT '/openapi/v2.0/manage/api/v1/organizations//manage-devices/hms' \
--header 'x-user-token;' \
--header 'x-user-token;' \
--header 'X-Request-Id;' \
--header 'X-Request-Id;' \
--header 'X-Project-Uuid;' \
--header 'Content-Type: application/json' \
--data '{
    "device_sn": "2TUDK87654321"
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "code": 0,
    "message": "OK",
    "data": null
}

🟠400

🔴500

Modified at 2026-06-15 13:36:31

Get Organization Device HMS Event List

Update Project Device HMS Read Time