POST
/
api
/
v1
/
open
/
device-requests
/
{request_id}
/
reply
Reply to a device request
curl --request POST \
  --url https://api.example.com/api/v1/open/device-requests/{request_id}/reply \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Id: <x-api-id>' \
  --header 'X-Api-Nonce: <x-api-nonce>' \
  --header 'X-Api-Signature: <api-key>' \
  --header 'X-Api-Timestamp: <x-api-timestamp>' \
  --data '
{
  "reply_code": "APPROVED",
  "reply_message": "approved",
  "payload": {
    "config_result": "ok"
  }
}
'
{
  "request_id": "devreq-001",
  "reply_code": "APPROVED",
  "reply_message": "approved",
  "reply_source": "OPEN_PLATFORM",
  "replied_at": "2026-04-22T12:01:00Z"
}

Authorizations

​
X-Api-Signature
string
header
required

HMAC signature; X-Api-Id, X-Api-Timestamp, and X-Api-Nonce are also required.

Headers

​
X-Api-Id
string
required

API credential ID.

​
X-Api-Timestamp
string
required

Unix timestamp in seconds.

​
X-Api-Nonce
string
required

Replay-protection nonce.

​
X-Api-Signature
string
required

HMAC request signature.

​
X-Request-Id
string

Optional correlation ID.

Path Parameters

​
request_id
string
required

Device request ID

Body

application/json
​
reply_code
string
required
Example:

"APPROVED"

​
reply_message
string
Example:

"approved"

​
payload
object
Example:
{ "config_result": "ok" }

Response

Reply accepted.

​
request_id
string
required
​
reply_code
string
required
​
reply_message
string
required
​
reply_source
string
required
​
replied_at
string<date-time> | null