Queue a Device Command

POST

/fingerprint/devices/{deviceId}/commands

Requires authenticated session and manage:fingerprint permission. Queues an allow-listed command for the device to collect on its next heartbeat. Only SET_TIME and INFO are accepted; the literal protocol string is built server-side and is never taken from the caller. Returns 422 if the device has not been approved.

Request

Authorization

API Key

Add parameter in cookie

core.session_token

Example:

core.session_token: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Bodyapplication/json

🟠400bad-request

🟠401unauthorized

🟠403forbidden

🟠404record-not-found

🟠422unprocessable-entity

🔴500server-error

Request Example

Shell

JavaScript

Java

Swift

curl --location '/fingerprint/devices//commands' \
--header 'Content-Type: application/json' \
--data '{
    "type": "SET_TIME"
}'

Response Example

201 - Example 1

{
    "success": true,
    "message": "string",
    "meta": {
        "page": 0,
        "limit": 0,
        "total": 0
    },
    "errors": [
        {
            "code": "CR-100001",
            "field": "string",
            "message": "string"
        }
    ],
    "result": {
        "id": "string",
        "deviceId": "string",
        "type": "SET_TIME",
        "command": "string",
        "status": "PENDING",
        "sentAt": "2019-08-24T14:15:22.123Z",
        "respondedAt": "2019-08-24T14:15:22.123Z",
        "returnCode": 0,
        "result": "string",
        "createdAt": "2019-08-24T14:15:22.123Z",
        "updatedAt": "2019-08-24T14:15:22.123Z"
    }
}

Modified at 2026-07-27 16:52:01

List Device Commands

Get All Locations