Skip to content

Error code · HTTP 403

device_key_required

Title
A device key is required
What happened
Hook checks (/v1/hooks/check) come from an enrolled device's Maskflare agent, with the device's own key; this key belongs to no device.
How to fix it
Let the Maskflare desktop agent install the hooks (the agent policy's coding-agent hooks setting); for your own scripts use /v1/mask with an API key.
Returned by
Gateway mode
Retry
Retrying the same request fails the same way.
Example response body
{
  "type": "https://maskflare.com/docs/errors/device_key_required",
  "title": "A device key is required",
  "status": 403,
  "code": "device_key_required",
  "detail": "Let the Maskflare desktop agent install the hooks (the agent policy's coding-agent hooks setting); for your own scripts use `/v1/mask` with an API key."
}

All error codes