Priority Host Authentication

This endpoint is used for priority DEVICE authentication which returns the authentication result as a response.

Method & Endpoint

Method: POST

Endpoint: /api/device/priorityHostAuth

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

Request Body

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

✅ Successful Response — 200 OK

{
  "status": [
    "AUTH_OK",
    "AUTH_NOT_OK",
    "CLAIM_TOKEN"
  ],
  "claimTokenId": "123e4567-e89b-12d3-a456-426614174000"
}

❌ 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.

← Host Authentication

Host Authentication with Ephemeral Key (EK) →