<botshield-verify> widget is served from one host, cdn.botshield.ai, at several paths. The path decides which version you get. Use it to stay on a version until you are ready to move.
Paths
The current stable version is
3.0.0, released with BotShield 3.0 on September 28, 2026. Version 2.0.1 stays available at /v/2/sdk.js and /v/2.0.1/sdk.js, with a deprecation header.
Which path to use
The major version is the first number. A major pin follows the minor and patch releases of that major version and never moves to the next one. Read the changelog before you move to a new major version.
Exact versions never change
A published exact version is immutable. A fix is released as a new patch version. It never replaces an existing file. You can use Subresource Integrity with an exact-version URL. Do not use it with/sdk.js, /v/<major>/sdk.js or /next/sdk.js, because those files change when a new version is published.
Response headers
Every response names the version it served.Deprecation headers
When the version you load belongs to an older major version than the latest, the response adds deprecation headers.
No version is removed without these headers being sent first.
Unknown versions
A version that was never published returns HTTP404. The widget is never replaced by a different version than the one you asked for.
The v query parameter
Older snippets load https://cdn.botshield.ai/sdk.js?v=17. The v query parameter is accepted and ignored. Those snippets keep working and receive the latest stable version. To choose a version, use a path from the table above.