Create a Navigation Policy
Create a navigation policy for this project. Omitted fields take the defaults: enabled, block by default, block unknown domains, no category rules, and no overrides. Bind the policy to a session with browserSettings.riskPolicyId.
Authorizations
Your Browserbase API Key.
Body
Display name. A policy's id identifies it, not its name.
1 - 128Free-form notes about the policy.
1024Whether the policy can be bound to new sessions. Running sessions keep the policy they started with. A disabled policy stays editable and can be re-enabled.
Decision for each of a domain's categories that has no category rule. The strictest of a domain's category decisions applies, and overrides take precedence.
allow, block Navigation categories. Browserbase blocks a domain in any blocked category, even if it is also in an allowed one.
adult, ai-tools, alcohol-tobacco, business, child-abuse, communication, dating, drugs, education, entertainment, finance, gambling, games, government-military, hacking, hate, health, illegal-activity, infrastructure, kids, lifestyle, malware, newly-registered, news, parked-inactive, phishing-scams, piracy, proxy-anonymizer, search-portal, self-harm, shopping, social-media, society-culture, sports, technology, terrorism-extremism, travel, url-shortener, violence, weapons Navigation categories. Browserbase blocks a domain in any blocked category, even if it is also in an allowed one.
adult, ai-tools, alcohol-tobacco, business, child-abuse, communication, dating, drugs, education, entertainment, finance, gambling, games, government-military, hacking, hate, health, illegal-activity, infrastructure, kids, lifestyle, malware, newly-registered, news, parked-inactive, phishing-scams, piracy, proxy-anonymizer, search-portal, self-harm, shopping, social-media, society-culture, sports, technology, terrorism-extremism, travel, url-shortener, violence, weapons Decision for a domain, or one of its categories, that Browserbase can't classify. It counts as one of the domain's category decisions, so the strictest still applies.
allow, block Per-host decisions that take precedence over category rules and the default. Each host may appear once.
500Response
The navigation policy has been created.
Rules for which domains a browser session may navigate to. Bind a policy to a session with browserSettings.riskPolicyId; Browserbase then allows or blocks each navigation by the policy's overrides, its category rules, and finally its default decision. A session keeps the policy as it was when the session started: edits, disables, and deletes apply to sessions that start afterwards. A policy checks navigations: page loads, iframes, popups, and each redirect. It doesn't check requests a page makes itself, such as scripts, images, and fetch calls. In a session that loads a Context, pages skip their service workers so that the policy checks every navigation.
Unique identifier for the navigation policy.
The project the policy belongs to.
Display name. A policy's id identifies it, not its name.
1 - 128Free-form notes about the policy.
1024Whether the policy can be bound to new sessions. Running sessions keep the policy they started with. A disabled policy stays editable and can be re-enabled.
Decision for each of a domain's categories that has no category rule. The strictest of a domain's category decisions applies, and overrides take precedence.
allow, block Navigation categories. Browserbase blocks a domain in any blocked category, even if it is also in an allowed one.
adult, ai-tools, alcohol-tobacco, business, child-abuse, communication, dating, drugs, education, entertainment, finance, gambling, games, government-military, hacking, hate, health, illegal-activity, infrastructure, kids, lifestyle, malware, newly-registered, news, parked-inactive, phishing-scams, piracy, proxy-anonymizer, search-portal, self-harm, shopping, social-media, society-culture, sports, technology, terrorism-extremism, travel, url-shortener, violence, weapons Navigation categories. Browserbase blocks a domain in any blocked category, even if it is also in an allowed one.
adult, ai-tools, alcohol-tobacco, business, child-abuse, communication, dating, drugs, education, entertainment, finance, gambling, games, government-military, hacking, hate, health, illegal-activity, infrastructure, kids, lifestyle, malware, newly-registered, news, parked-inactive, phishing-scams, piracy, proxy-anonymizer, search-portal, self-harm, shopping, social-media, society-culture, sports, technology, terrorism-extremism, travel, url-shortener, violence, weapons Decision for a domain, or one of its categories, that Browserbase can't classify. It counts as one of the domain's category decisions, so the strictest still applies.
allow, block Per-host decisions that take precedence over category rules and the default. Each host may appear once.
500