Skip to main content

CFL102 - Cloudflare List Lookup Failed

Agent error code #CFL102 indicates that the Knocknoc backend tried to resolve the configured Cloudflare list name to a list ID, but Cloudflare returned an unexpected response. The list may well exist; the request to enumerate lists did not succeed.

This differs from related codes:

  • If the API rejected the token, the error is reported as an authentication (#CFL001) or authorization (#CFL002) failure instead
  • If the request never reached Cloudflare, it is reported as a connection failure (#CFL000)
  • If the list simply does not exist in the account, it is reported as list not found (#CFL101)

Common causes include:

  • A transient Cloudflare API error (HTTP 5xx)
  • An unexpected or malformed response body the agent could not parse
  • The account has an unusually large number of lists and the response was truncated by an intermediary

Steps to Resolve

Retry the Grant

  1. Cloudflare API errors are often transient; retry the grant after a short wait
  2. Check the Cloudflare status page for ongoing incidents

Configure the List by ID

If the lookup keeps failing, set the List ID directly on the Knocknoc backend configuration.

  1. Open the list in the Cloudflare dashboard and copy its ID from the end of the URL.
  2. Paste it into the List ID field of the Knocknoc backend configuration; the agent then skips the name lookup entirely
Back to top