List the project’s navigation policies, ordered by name.
GET
/
v1
/
navigation-policies
Node.js
import Browserbase from "@browserbasehq/sdk";
const bb = new Browserbase({
apiKey: process.env.BROWSERBASE_API_KEY,
});
const { data: policies } = await bb.navigationPolicies.list();
for (const policy of policies) {
console.log(policy.id, policy.name);
}
import os
from browserbase import Browserbase
bb = Browserbase(api_key=os.environ["BROWSERBASE_API_KEY"])
policies = bb.navigation_policies.list().data
for policy in policies:
print(policy.id, policy.name)
curl --request GET \
--url https://api.browserbase.com/v1/navigation-policies \
--header "X-BB-API-Key: $BROWSERBASE_API_KEY"
The project's navigation policies, ordered by name.
Show child attributes
Was this page helpful?
⌘I
Node.js
import Browserbase from "@browserbasehq/sdk";
const bb = new Browserbase({
apiKey: process.env.BROWSERBASE_API_KEY,
});
const { data: policies } = await bb.navigationPolicies.list();
for (const policy of policies) {
console.log(policy.id, policy.name);
}
import os
from browserbase import Browserbase
bb = Browserbase(api_key=os.environ["BROWSERBASE_API_KEY"])
policies = bb.navigation_policies.list().data
for policy in policies:
print(policy.id, policy.name)
curl --request GET \
--url https://api.browserbase.com/v1/navigation-policies \
--header "X-BB-API-Key: $BROWSERBASE_API_KEY"
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Browserbase Documentation","description":"Browserbase is the Browser Agent Platform: one API key gives your agent everything it needs to browse and interact with the web like a human: Browsers, Fetch, Search, Agent Identity, Functions, and the Model Gateway.","colors":{"primary":"#F03603","light":"#F03603","dark":"#F03603"},"logo":{"light":"https://mintcdn.com/browserbase/SoYEm-IyDzD4GuwP/logo/light.svg?fit=max\u0026auto=format\u0026n=SoYEm-IyDzD4GuwP\u0026q=85\u0026s=67d2dac0a6cdd091f364c6763a3393cd","dark":"https://mintcdn.com/browserbase/SoYEm-IyDzD4GuwP/logo/dark.svg?fit=max\u0026auto=format\u0026n=SoYEm-IyDzD4GuwP\u0026q=85\u0026s=a5e13fbe06c29ec92c87ddef9a46b1c8","href":"https://www.browserbase.com"},"favicon":"https://mintcdn.com/browserbase/giE_cpy18f2mWHqr/favicon.svg?fit=max\u0026auto=format\u0026n=giE_cpy18f2mWHqr\u0026q=85\u0026s=e01181f881b1e04052b2ad95c52bdca0","navbar":{"primary":{"type":"button","label":"Support","href":"https://portal.usepylon.com/browserbase/forms/talk-to-an-engineer"}},"footer":{"socials":{"website":"https://www.browserbase.com","x":"https://x.com/browserbase","github":"https://github.com/browserbase","linkedin":"https://www.linkedin.com/company/browserbasehq"}},"seo":{"indexing":"all"},"fonts":{"heading":{"family":"Inter"},"body":{"family":"Inter"}},"integrations":{"gtm":{"tagId":"GTM-WL6V5CB8"},"posthog":{"apiKey":"phc_L5OdEhuGyIcW1JtLxco9njLYnuUx10mqlVe6Tj54kHS","apiHost":"https://us.i.posthog.com"}},"contextual":{"options":["copy","chatgpt","claude","view","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"browserbase","hasAudioNarration":false,"actualSubdomain":"browserbase","customDomains":["docs.browserbase.com"],"gitSource":{"type":"github","owner":"browserbase","repo":"core","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae283a65908e9c7fec8d098","collectionId":"cf56bc35-ab8a-44ad-97d6-5d2078bad04b","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae283a65908e9c7fec8d098"},"feedback":{"thumbs":true,"edits":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4cc9e981729a4c3986753","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"Integrations","count":150},{"language":"default","tag":"Docs","count":86},{"language":"default","tag":"APIs \u0026 SDKs","count":71},{"language":"default","tag":"APIs","count":67},{"language":"default","tag":"Platform","count":60},{"language":"default","tag":"Browsers","count":27},{"language":"default","tag":"Agents","count":14},{"language":"default","tag":"Functions API","count":14},{"language":"default","tag":"Sessions API","count":11},{"language":"default","tag":"Agents API","count":11}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instinct-self-updating-docs","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"*{border-radius:0!important}.responsive-columns{--_cols:var(--cols, 1);--_cols-effective:min(1, var(--_cols));grid-template-columns:repeat(var(--_cols-effective),1fr)!important}@container columns-container (min-width: 36rem){.responsive-columns{--_cols-effective:min(2, var(--_cols))}}@container columns-container (min-width: 48rem){.responsive-columns{--_cols-is-4:calc(1 - sign(abs(var(--_cols) - 4)));--_cols-effective:calc(min(3, var(--_cols)) - var(--_cols-is-4))}}@container columns-container (min-width: 64rem){.responsive-columns{--_cols-effective:var(--_cols)}}"}],"page":{"pagePath":"reference/api/list-navigation-policies","slug":"/reference/api/list-navigation-policies","pageMetadata":{"openapi":"get /v1/navigation-policies","title":"List Navigation Policies","description":"List the project's navigation policies, ordered by name.","href":"/reference/api/list-navigation-policies"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"List the project’s navigation policies, ordered by name.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"get /v1/navigation-policies","title":"List Navigation Policies","description":"List the project's navigation policies, ordered by name.","href":"/reference/api/list-navigation-policies"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/browserbase/34f72216f660e6f7/signals.js"],"openApiReferenceData":{"operation":{"operationId":"NavigationPolicies_list","summary":"List Navigation Policies","description":"List the project's navigation policies, ordered by name.","responses":{"200":"a70856ee-e2eb-4089-b61e-f9986dea41ea"},"x-codeSamples":[{"lang":"javascript","label":"Node.js","source":"import Browserbase from \"@browserbasehq/sdk\";\n\nconst bb = new Browserbase({\n apiKey: process.env.BROWSERBASE_API_KEY,\n});\n\nconst { data: policies } = await bb.navigationPolicies.list();\n\nfor (const policy of policies) {\n console.log(policy.id, policy.name);\n}"},{"lang":"python","label":"Python","source":"import os\n\nfrom browserbase import Browserbase\n\nbb = Browserbase(api_key=os.environ[\"BROWSERBASE_API_KEY\"])\n\npolicies = bb.navigation_policies.list().data\n\nfor policy in policies:\n print(policy.id, policy.name)"},{"lang":"bash","label":"cURL","source":"curl --request GET \\\n --url https://api.browserbase.com/v1/navigation-policies \\\n --header \"X-BB-API-Key: $BROWSERBASE_API_KEY\""}],"method":"get","type":"path","servers":["a00435b8-3f60-448f-afbd-22a0fb937d94"],"security":["4dfc7617-9228-4e88-a39e-d4e37a778a49"],"path":"/v1/navigation-policies","baseUrlOptions":["https://api.browserbase.com"],"title":"List Navigation Policies","codeSamples":[{"label":"Node.js","lang":"javascript","source":"import Browserbase from \"@browserbasehq/sdk\";\n\nconst bb = new Browserbase({\n apiKey: process.env.BROWSERBASE_API_KEY,\n});\n\nconst { data: policies } = await bb.navigationPolicies.list();\n\nfor (const policy of policies) {\n console.log(policy.id, policy.name);\n}"},{"label":"Python","lang":"python","source":"import os\n\nfrom browserbase import Browserbase\n\nbb = Browserbase(api_key=os.environ[\"BROWSERBASE_API_KEY\"])\n\npolicies = bb.navigation_policies.list().data\n\nfor policy in policies:\n print(policy.id, policy.name)"},{"label":"cURL","lang":"bash","source":"curl --request GET \\\n --url https://api.browserbase.com/v1/navigation-policies \\\n --header \"X-BB-API-Key: $BROWSERBASE_API_KEY\""}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{},"responses":{"a70856ee-e2eb-4089-b61e-f9986dea41ea":{"description":"The project's navigation policies.","content":{"application/json":{"schema":{"description":"The project's navigation policies.","type":"object","properties":{"data":{"description":"The project's navigation policies, ordered by name.","type":"array","items":{"description":"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.","type":"object","properties":{"id":{"description":"Unique identifier for the navigation policy.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].id","typeLabel":"string"},"projectId":{"description":"The project the policy belongs to.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].projectId","typeLabel":"string"},"name":{"description":"Display name. A policy's id identifies it, not its name.","type":"string","maxLength":128,"minLength":1,"isRequired":true,"uniqueKey":"data.items.[INDEX].name","typeLabel":"string"},"description":{"description":"Free-form notes about the policy.","type":"string","maxLength":1024,"isRequired":true,"uniqueKey":"data.items.[INDEX].description","typeLabel":"string"},"enabled":{"description":"Whether 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.","type":"boolean","isRequired":true,"uniqueKey":"data.items.[INDEX].enabled","typeLabel":"boolean"},"defaultDecision":{"description":"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.","type":"string","enum":["allow","block"],"isRequired":true,"uniqueKey":"data.items.[INDEX].defaultDecision","typeLabel":"enum\u003cstring>"},"allowedCategories":{"description":"Navigation categories. Browserbase blocks a domain in any blocked category, even if it is also in an allowed one.","type":"array","items":{"type":"string","enum":["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"],"uniqueKey":"data.items.[INDEX].allowedCategories.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueItems":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].allowedCategories","typeLabel":"enum\u003cstring>[]"},"blockedCategories":{"description":"Navigation categories. Browserbase blocks a domain in any blocked category, even if it is also in an allowed one.","type":"array","items":{"type":"string","enum":["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"],"uniqueKey":"data.items.[INDEX].blockedCategories.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueItems":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].blockedCategories","typeLabel":"enum\u003cstring>[]"},"unknownDomainBehavior":{"description":"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.","type":"string","enum":["allow","block"],"isRequired":true,"uniqueKey":"data.items.[INDEX].unknownDomainBehavior","typeLabel":"enum\u003cstring>"},"domainOverrides":{"description":"Per-host decisions that take precedence over category rules and the default. Each host may appear once.","type":"array","items":{"additionalProperties":false,"type":"object","properties":{"domain":{"description":"Host the override applies to, for example `example.com`. Matching is case-insensitive and covers subdomains.","type":"string","format":"hostname","maxLength":253,"minLength":1,"isRequired":true,"uniqueKey":"data.items.[INDEX].domainOverrides.items.[INDEX].domain","typeLabel":"string\u003chostname>"},"decision":{"description":"Decision for navigations to this host.","type":"string","enum":["allow","block"],"isRequired":true,"uniqueKey":"data.items.[INDEX].domainOverrides.items.[INDEX].decision","typeLabel":"enum\u003cstring>"}},"required":["domain","decision"],"uniqueKey":"data.items.[INDEX].domainOverrides.items.[INDEX]","typeLabel":"object"},"maxItems":500,"isRequired":true,"uniqueKey":"data.items.[INDEX].domainOverrides","typeLabel":"object[]"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.items.[INDEX].updatedAt","typeLabel":"string\u003cdate-time>"}},"required":["id","projectId","name","description","enabled","defaultDecision","allowedCategories","blockedCategories","unknownDomainBehavior","domainOverrides","createdAt","updatedAt"],"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data","typeLabel":"object[]"}},"required":["data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"id":"\u003cstring>","projectId":"\u003cstring>","name":"\u003cstring>","description":"\u003cstring>","enabled":true,"defaultDecision":"allow","allowedCategories":["adult"],"blockedCategories":["adult"],"unknownDomainBehavior":"allow","domainOverrides":[{"domain":"\u003cstring>","decision":"allow"}],"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"4dfc7617-9228-4e88-a39e-d4e37a778a49":{"BrowserbaseAuth":{"type":"apiKey","in":"header","name":"X-BB-API-Key","description":"Your [Browserbase API Key](https://www.browserbase.com/settings).","scopes":[],"schemeName":"BrowserbaseAuth"}}},"servers":{"a00435b8-3f60-448f-afbd-22a0fb937d94":{"url":"https://api.browserbase.com","description":"Public endpoint","variables":{}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-BB-API-Key","description":"Your [Browserbase API Key](https://www.browserbase.com/settings).","scopes":[],"schemeName":"BrowserbaseAuth"},"schema":{"title":"X-BB-API-Key","type":"string","description":"Your [Browserbase API Key](https://www.browserbase.com/settings).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"BrowserbaseAuth","name":"X-BB-API-Key"}],"title":"BrowserbaseAuth"}]},"originalFileLocation":"reference/api/openapi.v1.yaml"},"subdomain":"browserbase","siteName":"Browserbase Documentation","title":"List Navigation Policies - Browserbase Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T16:58:49.833Z","originalFileLocation":"reference/api/list-navigation-policies.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"List the project\u0026#x27;s navigation policies, ordered by name.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Browserbase Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/browserbase/0gEfmyCMfQGLZuAR/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/browserbase/0gEfmyCMfQGLZuAR/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/browserbase/0gEfmyCMfQGLZuAR/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/browserbase/0gEfmyCMfQGLZuAR/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/browserbase/0gEfmyCMfQGLZuAR/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/browserbase/0gEfmyCMfQGLZuAR/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/browserbase/0gEfmyCMfQGLZuAR/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/browserbase/0gEfmyCMfQGLZuAR/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/browserbase/0gEfmyCMfQGLZuAR/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List Navigation Policies - Browserbase Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"List the project\u0026#x27;s navigation policies, ordered by name.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Browserbase Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.browserbase.com/reference/api/list-navigation-policies\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://browserbase.mintlify.app/_mintlify/api/og/v2?division=Navigation+policies+API\u0026amp;title=List+Navigation+Policies\u0026amp;description=List+the+project%27s+navigation+policies%2C+ordered+by+name.\u0026amp;theme=f6e15f8a9d26c9b10f69dd26\u0026amp;signature=8e6bae805406d951bc8bf5f3a677fa9ba396ab1bd504c2412107c4ca84518817\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List Navigation Policies - Browserbase Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List the project\u0026#x27;s navigation policies, ordered by name.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://browserbase.mintlify.app/_mintlify/api/og/v2?division=Navigation+policies+API\u0026amp;title=List+Navigation+Policies\u0026amp;description=List+the+project%27s+navigation+policies%2C+ordered+by+name.\u0026amp;theme=f6e15f8a9d26c9b10f69dd26\u0026amp;signature=8e6bae805406d951bc8bf5f3a677fa9ba396ab1bd504c2412107c4ca84518817\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/browserbase/0gEfmyCMfQGLZuAR/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Browserbase Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F03603\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.browserbase.com/reference/api/list-navigation-policies\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/api/list-navigation-policies.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.browserbase.com/#organization\",\"name\":\"Browserbase Documentation\",\"url\":\"https://docs.browserbase.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/browserbase/SoYEm-IyDzD4GuwP/logo/light.svg?fit=max\u0026auto=format\u0026n=SoYEm-IyDzD4GuwP\u0026q=85\u0026s=67d2dac0a6cdd091f364c6763a3393cd\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.browserbase.com#website\",\"name\":\"Browserbase Documentation\",\"url\":\"https://docs.browserbase.com\",\"publisher\":{\"@id\":\"https://docs.browserbase.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.browserbase.com/reference/api/list-navigation-policies#webpage\",\"url\":\"https://docs.browserbase.com/reference/api/list-navigation-policies\",\"name\":\"List Navigation Policies\",\"description\":\"List the project's navigation policies, ordered by name.\",\"dateModified\":\"2026-10-30T16:58:49.833Z\",\"isPartOf\":{\"@id\":\"https://docs.browserbase.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.browserbase.com/reference/api/list-navigation-policies#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.browserbase.com/reference/api/list-navigation-policies#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"APIs\",\"item\":\"https://docs.browserbase.com/reference/api/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Navigation policies API\",\"item\":\"https://docs.browserbase.com/reference/api/create-a-navigation-policy\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"List Navigation Policies\",\"item\":\"https://docs.browserbase.com/reference/api/list-navigation-policies\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.browserbase.com/reference/api/list-navigation-policies#apireference\",\"headline\":\"List Navigation Policies\",\"name\":\"List Navigation Policies\",\"description\":\"List the project's navigation policies, ordered by name.\",\"url\":\"https://docs.browserbase.com/reference/api/list-navigation-policies\",\"mainEntityOfPage\":{\"@id\":\"https://docs.browserbase.com/reference/api/list-navigation-policies#webpage\"},\"dateModified\":\"2026-10-30T16:58:49.833Z\",\"publisher\":{\"@id\":\"https://docs.browserbase.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.browserbase.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Browserbase Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Browserbase Documentation","nav":{"global":null,"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":"/welcome/introduction"}]},{"tab":"APIs \u0026 SDKs","groups":[{"group":"Overview","pages":[{"title":"APIs and SDKs","sidebarTitle":"Introduction","href":"/reference/introduction"}]},{"group":"SDKs","pages":[{"title":"Overview","href":"/reference/sdk/overview"},{"title":"Node.js SDK","href":"/reference/sdk/nodejs"},{"title":"Python SDK","href":"/reference/sdk/python"}]},{"group":"APIs","pages":[{"title":"Overview","href":"/reference/api/overview"},{"group":"Sessions API","pages":[{"openapi":"post /v1/sessions","title":"Create a Session","href":"/reference/api/create-a-session"},{"openapi":"get /v1/sessions","title":"List Sessions","href":"/reference/api/list-sessions"},{"openapi":"get /v1/sessions/{id}","title":"Get a Session","href":"/reference/api/get-a-session"},{"title":"Update a Session","openapi":"post /v1/sessions/{id}","href":"/reference/api/update-a-session"},{"openapi":"get /v1/sessions/{id}/debug","title":"Session Live URLs","href":"/reference/api/session-live-urls"},{"openapi":"get /v1/sessions/{id}/logs","title":"Session Logs","href":"/reference/api/session-logs"},{"openapi":"get /v1/sessions/{id}/replays","title":"Get Session Replay","href":"/reference/api/session-replays"},{"openapi":"get /v1/sessions/{id}/replays/{pageId}","title":"Get Replay Page","href":"/reference/api/session-replay-page"},{"openapi":"post /v1/sessions/{id}/recording/downloads","title":"Create Session Recording Downloads","href":"/reference/api/create-session-recording-downloads"},{"openapi":"get /v1/sessions/{id}/recording/downloads","title":"List Session Recording Downloads","href":"/reference/api/list-session-recording-downloads"},{"openapi":"post /v1/sessions/{id}/uploads","title":"Create Session Uploads","href":"/reference/api/create-session-uploads"}]},{"group":"Fetch API","pages":[{"openapi":"post /v1/fetch","title":"Fetch a Page","href":"/reference/api/fetch-a-page"}]},{"group":"Search API","pages":[{"openapi":"post /v1/search","title":"Web Search","href":"/reference/api/web-search"}]},{"group":"Agents API","pages":[{"group":"Runs","pages":[{"openapi":"post /v1/agents/runs","title":"Run an Agent","href":"/reference/api/run-an-agent"},{"openapi":"get /v1/agents/runs/{runId}","title":"Get a Run","href":"/reference/api/get-a-run"},{"openapi":"get /v1/agents/runs","title":"List Runs","href":"/reference/api/list-runs"},{"openapi":"get /v1/agents/runs/{runId}/messages","title":"List Run Messages","href":"/reference/api/list-run-messages"},{"openapi":"post /v1/agents/runs/{runId}/resume","title":"Resume a Run","href":"/reference/api/resume-a-run"},{"openapi":"post /v1/agents/runs/{runId}/stop","title":"Stop a Run","href":"/reference/api/stop-a-run"}]},{"group":"Agents","pages":[{"openapi":"post /v1/agents","title":"Create an Agent","href":"/reference/api/create-an-agent"},{"openapi":"get /v1/agents/{agentId}","title":"Get an Agent","href":"/reference/api/get-an-agent"},{"openapi":"get /v1/agents","title":"List Agents","href":"/reference/api/list-agents"},{"openapi":"patch /v1/agents/{agentId}","title":"Update an Agent","href":"/reference/api/update-an-agent"},{"openapi":"delete /v1/agents/{agentId}","title":"Delete an Agent","href":"/reference/api/delete-an-agent"}]}]},{"group":"Functions API","pages":[{"openapi":"get /v1/functions","title":"List Functions","href":"/reference/api/list-functions"},{"openapi":"get /v1/functions/{id}","title":"Get a Function","href":"/reference/api/get-a-function"},{"openapi":"post /v1/functions/{id}/invoke","title":"Invoke a Function","href":"/reference/api/invoke-a-function"},{"group":"Secrets","pages":[{"openapi":"get /v1/functions/{id}/secrets","title":"List Function Secrets","href":"/reference/api/list-function-secrets"},{"openapi":"post /v1/functions/{id}/secrets","title":"Attach a Secret to a Function","href":"/reference/api/attach-a-secret-to-a-function"},{"openapi":"delete /v1/functions/{id}/secrets/{secretId}","title":"Detach a Secret from a Function","href":"/reference/api/detach-a-secret-from-a-function"}]},{"group":"Versions","pages":[{"openapi":"get /v1/functions/{id}/versions","title":"List Function Versions","href":"/reference/api/list-function-versions"},{"openapi":"get /v1/functions/versions/{id}","title":"Get a Function Version","href":"/reference/api/get-a-function-version"}]},{"group":"Builds","pages":[{"openapi":"get /v1/functions/builds","title":"List Function Builds","href":"/reference/api/list-function-builds"},{"openapi":"get /v1/functions/builds/{id}","title":"Get a Function Build","href":"/reference/api/get-a-function-build"},{"openapi":"get /v1/functions/builds/{id}/logs","title":"Get Function Build Logs","href":"/reference/api/get-function-build-logs"}]},{"group":"Invocations","pages":[{"openapi":"get /v1/functions/invocations/{id}","title":"Get an Invocation","href":"/reference/api/get-an-invocation"},{"openapi":"get /v1/functions/invocations/{id}/logs","title":"Get Invocation Logs","href":"/reference/api/get-invocation-logs"},{"openapi":"get /v1/functions/versions/{id}/invocations","title":"List Invocations for a Function Version","href":"/reference/api/list-version-invocations"}]}]},{"group":"Secrets API","pages":[{"openapi":"get /v1/secrets/keypair","title":"Get a Keypair","href":"/reference/api/get-a-keypair"},{"openapi":"post /v1/secrets","title":"Create a Secret","href":"/reference/api/create-a-secret"},{"openapi":"get /v1/secrets","title":"List Secrets","href":"/reference/api/list-secrets"},{"openapi":"get /v1/secrets/{id}","title":"Get a Secret","href":"/reference/api/get-a-secret"},{"openapi":"patch /v1/secrets/{id}","title":"Update a Secret","href":"/reference/api/update-a-secret"},{"openapi":"delete /v1/secrets/{id}","title":"Delete a Secret","href":"/reference/api/delete-a-secret"}]},{"group":"Downloads API","pages":[{"openapi":"get /v1/downloads","title":"List Downloads","href":"/reference/api/list-downloads"},{"openapi":"get /v1/downloads/{id}","title":"Get a Download","href":"/reference/api/get-a-download"},{"openapi":"delete /v1/downloads/{id}","title":"Delete a Download","href":"/reference/api/delete-a-download"}]},{"group":"Contexts API","pages":[{"openapi":"post /v1/contexts","title":"Create a Context","href":"/reference/api/create-a-context"},{"openapi":"get /v1/contexts/{id}","title":"Get a Context","href":"/reference/api/get-a-context"},{"openapi":"delete /v1/contexts/{id}","title":"Delete a Context","href":"/reference/api/delete-a-context"}]},{"group":"Navigation policies API","pages":[{"openapi":"post /v1/navigation-policies","title":"Create a Navigation Policy","description":"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`.","href":"/reference/api/create-a-navigation-policy"},{"openapi":"get /v1/navigation-policies","title":"List Navigation Policies","href":"/reference/api/list-navigation-policies"},{"openapi":"get /v1/navigation-policies/{id}","title":"Get a Navigation Policy","description":"Retrieve a single navigation policy by ID.","href":"/reference/api/get-a-navigation-policy"},{"openapi":"patch /v1/navigation-policies/{id}","title":"Update a Navigation Policy","href":"/reference/api/update-a-navigation-policy"},{"openapi":"delete /v1/navigation-policies/{id}","title":"Delete a Navigation Policy","href":"/reference/api/delete-a-navigation-policy"}]},{"group":"Extensions API","pages":[{"openapi":"post /v1/extensions","title":"Upload an Extension","href":"/reference/api/upload-an-extension"},{"openapi":"get /v1/extensions/{id}","title":"Get an Extension","href":"/reference/api/get-an-extension"},{"openapi":"delete /v1/extensions/{id}","title":"Delete an Extension","href":"/reference/api/delete-an-extension"}]},{"group":"Certificates API","pages":[{"openapi":"post /v1/certificates","title":"Upload a Certificate","href":"/reference/api/upload-a-certificate"},{"openapi":"get /v1/certificates","title":"List Certificates","href":"/reference/api/list-certificates"},{"openapi":"get /v1/certificates/{id}","title":"Get a Certificate","href":"/reference/api/get-a-certificate"},{"openapi":"delete /v1/certificates/{id}","title":"Delete a Certificate","href":"/reference/api/delete-a-certificate"}]},{"group":"Webhooks API","pages":[{"openapi":"post /v1/webhooks","title":"Create a Webhook","href":"/reference/api/create-a-webhook"},{"openapi":"get /v1/webhooks","title":"List Webhooks","href":"/reference/api/list-webhooks"},{"openapi":"get /v1/webhooks/{id}","title":"Get a Webhook","href":"/reference/api/get-a-webhook"},{"openapi":"patch /v1/webhooks/{id}","title":"Update a Webhook","href":"/reference/api/update-a-webhook"},{"openapi":"delete /v1/webhooks/{id}","title":"Delete a Webhook","href":"/reference/api/delete-a-webhook"},{"openapi":"post /v1/webhooks/{id}/secret","title":"Rotate a Webhook signing secret","href":"/reference/api/rotate-a-webhook-signing-secret"}]},{"group":"Projects API","pages":[{"openapi":"get /v1/projects","title":"List Projects","href":"/reference/api/list-projects"},{"openapi":"get /v1/projects/{id}","title":"Get a Project","href":"/reference/api/get-a-project"},{"openapi":"get /v1/projects/{id}/usage","title":"Get Project Usage","href":"/reference/api/get-project-usage"}]}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/get-started"}]},{"tab":"Templates ↗","href":"https://www.browserbase.com/templates"},{"tab":"Stagehand ↗","href":"https://docs.stagehand.dev/"},{"tab":"Changelog ↗","href":"https://www.browserbase.com/changelog"},{"tab":"Dashboard ↗","href":"https://www.browserbase.com/overview"}]},"title":"List Navigation Policies - Browserbase Documentation","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-CT9uE8Ip.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}