p202 click-filter test

Test whether a click from an address would be filtered, and by which rule

New in 1.9.79
All commands

p202 CLI reference

Back to the docs

01Jobs it does

Each one is a real command line. Copy it, or open it in the builder below to change it.

would this address be filtered

p202 click-filter test <ip>

02What you get

Pick the shape you need. People get a table. Add --json, --csv or --ndjson for scripts, or -q for ids only. An AI agent gets compact JSON without asking. All output formats

03Build your command

Pick values and the command line writes itself, quoted and ready to paste.

p202 click-filter test

Set flags below; the command updates as you type.

04Flags

1 flag, plus the global flags every command takes.

FlagWhat it does
--user-idstringAccount whose click filter this is (default: the API key's own user)

05How it works

Asks every rule about one address and answers the decision (filtered, reason), the list entry it falls in, and each check's own answer. Read only: nothing is recorded. repeat_visit says whether the address has a click in the window already, so its next one would be filtered.

06For agents

Running this from an agent

  • Read the same facts as JSON: p202 commands click-filter test --json.
  • With AI_AGENT, CLAUDECODE or another agent variable set, output is compact JSON and errors arrive on stderr as a JSON envelope with a hint.
  • Exit codes: 0 ok, 1 bad input, 2 auth, 3 network, 4 server error, 5 partial failure, 6 no Pro licence on the install.
p202 commands click-filter test --json
{
  "path": "p202 click-filter test",
  "use": "test <ip>",
  "short": "Test whether a click from an address would be filtered, and by which rule",
  "long": "Asks every rule about one address and answers the decision (filtered, reason), the list entry it\nfalls in, and each check's own answer. Read only: nothing is recorded. repeat_visit says whether\nthe address has a click in the window already, so its next one would be filtered.",
  "runnable": true,
  "example": "p202 click-filter test 203.0.113.7",
  "tasks": [
    {
      "run": "p202 click-filter test",
      "phrases": [
        "would this address be filtered"
      ]
    }
  ],
  "flags": [
    {
      "name": "user-id",
      "type": "string",
      "default": "",
      "usage": "Account whose click filter this is (default: the API key's own user)",
      "required": false
    }
  ]
}