Priority Host Response Word Request

This endpoint accepts the host challenge word (HCW) and TID. It is used to request a host response word (HRW) for a Host CW.

Method & Endpoint

Method: POST

Endpoint: /api/device/priorityRequestHRW

Headers: CF-Access-Client-ID and CF-Access-Client-Secret

Request Body

{
  "requestSignedResponse": false,
  "TID": "800000001000000010000000000000014464b592da61f3fd5506fcb1f37f4bef",
  "HCW": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}

✅ Successful Response — 200 OK

{
  "status": {
    "PROCESSING": "PROCESSING",
    "NOT_READY": "NOT_READY",
    "AUTH_NOT_OK": "AUTH_NOT_OK",
    "GENERATED_HRW": "GENERATED_HRW"
  },
  "HRW": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
}

❌ Error Responses

401 Unauthorized — Invalid authentication

{
  "statusCode": 401,
  "message": "Unauthorized"
}

403 Forbidden — Authorization Forbidden

{
  "statusCode": 403,
  "message": "Invalid request",
  "error": "Forbidden"
}

520 Web Server Returned an Unknown Error — The origin server returned an empty, unknown, or unexpected response to Cloudflare.