CAPTCHA

A solveCaptcha invocation clears a CAPTCHA on the active page. It runs inside the runtime, with no CDP round-trips.

Solve a CAPTCHA

1
const result = await bctrl.runtimes.invocations.createAndWait(runtime.id, {
2
  action: "solveCaptcha",
3
  page: "active",
4
});
5
6
console.log(result.status, result.output);

The action targets the runtime’s active page. Add timeoutMs to bound how long the solve runs.

Inside agents

Grant a hosted agent the captcha builtin through a toolset, and it solves challenges as part of a larger task.

1
await bctrl.runtimes.invocations.browserUse.agent(runtime.id, {
2
  instruction: "Sign in and download the latest statement.",
3
  toolsetId: "tset_with_captcha",
4
});

Stealth first

Many challenges never appear when the runtime runs with stealth and a residential proxy. Solve explicitly when one still blocks the flow. See Runtime configuration.

Next

• Hosted agents - solve as part of a task
• Runtime configuration - avoid challenges with stealth
• Proxies - residential and rotating proxies