Skip to main content

CFL050 - Failed to Submit the List Update

Agent error code #CFL050 indicates that Knocknoc could not send its list changes to Cloudflare. Changes are sent as a single bulk update, and that update was never accepted.

A grant is only reported as applied once Cloudflare has taken the change. This code means it did not, so the address was never added to the list.

Common causes include:

  • A connectivity or DNS failure between the agent and the Cloudflare API
  • The token was rejected or lacks the edit permission, reported alongside #CFL001 or #CFL002
  • Cloudflare returned a server-side error for the bulk operation

Steps to Resolve

Check the Accompanying Code

This code is reported with the underlying cause appended. If that names an authentication or authorization failure, resolve that first: see #CFL001 and #CFL002.

Confirm Connectivity

curl -sS -o /dev/null -w '%{http_code}\n' https://api.cloudflare.com/client/v4/user/tokens/verify

Any connection error is the same one the agent is hitting. See #CFL000 for the network-level checks.

Check the Cloudflare Status Page

A server-side error usually clears on its own. Check the Cloudflare status page before investigating further.

Retry the Grant

Knocknoc gives up after a bounded number of attempts rather than holding the grant open indefinitely, so once the underlying cause is fixed, retry the grant from the Knocknoc admin interface rather than waiting for the original one.

Back to top