> ## Documentation Index > Fetch the complete documentation index at: https://docs.stagehand.dev/llms.txt > Use this file to discover all available pages before exploring further. # Navigate to a URL > Navigates the browser to the specified URL. ## OpenAPI ````yaml https://app.stainless.com/api/spec/documented/stagehand/openapi.documented.yml post /v1/sessions/{id}/navigate openapi: 3.1.0 info: title: Stagehand API version: 3.1.0 description: >- Stagehand SDK for AI browser automation [ALPHA]. This API allows clients to execute browser automation tasks remotely on the Browserbase cloud. All endpoints except /sessions/start require an active session ID. Responses are streamed using Server-Sent Events (SSE) when the `x-stream-response: true` header is provided. This SDK is currently ALPHA software and is not production ready! Please try it and give us your feedback, stay tuned for upcoming release announcements! contact: name: Browserbase url: https://browserbase.com servers: - url: https://api.stagehand.browserbase.com security: - BrowserbaseApiKey: [] BrowserbaseProjectId: [] paths: /v1/sessions/{id}/navigate: post: summary: Navigate to a URL description: Navigates the browser to the specified URL. operationId: SessionNavigate parameters: - schema: description: Unique session identifier example: c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123 type: string in: path name: id required: true description: Unique session identifier - schema: description: Whether to stream the response via SSE example: 'true' type: string enum: - 'true' - 'false' in: header name: x-stream-response description: Whether to stream the response via SSE requestBody: content: application/json: schema: $ref: '#/components/schemas/NavigateRequest' required: true responses: '200': description: Default Response content: application/json: schema: $ref: '#/components/schemas/NavigateResponse' x-codeSamples: - lang: JavaScript source: >- import Stagehand from 'stagehand-sdk'; const client = new Stagehand({ browserbaseAPIKey: process.env['BROWSERBASE_API_KEY'], // This is the default and can be omitted browserbaseProjectID: process.env['BROWSERBASE_PROJECT_ID'], // This is the default and can be omitted modelAPIKey: process.env['MODEL_API_KEY'], // This is the default and can be omitted }); const response = await client.sessions.navigate('c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123', { url: 'https://example.com', }); console.log(response.data); - lang: Python source: |- import os from stagehand import Stagehand client = Stagehand( browserbase_api_key=os.environ.get("BROWSERBASE_API_KEY"), # This is the default and can be omitted browserbase_project_id=os.environ.get("BROWSERBASE_PROJECT_ID"), # This is the default and can be omitted model_api_key=os.environ.get("MODEL_API_KEY"), # This is the default and can be omitted ) response = client.sessions.navigate( id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123", url="https://example.com", ) print(response.data) - lang: Go source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/browserbase/stagehand-go\"\n\t\"github.com/browserbase/stagehand-go/option\"\n)\n\nfunc main() {\n\tclient := stagehand.NewClient(\n\t\toption.WithBrowserbaseAPIKey(\"My Browserbase API Key\"),\n\t\toption.WithBrowserbaseProjectID(\"My Browserbase Project ID\"),\n\t\toption.WithModelAPIKey(\"My Model API Key\"),\n\t)\n\tresponse, err := client.Sessions.Navigate(\n\t\tcontext.TODO(),\n\t\t\"c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123\",\n\t\tstagehand.SessionNavigateParams{\n\t\t\tURL: \"https://example.com\",\n\t\t},\n\t)\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", response.Data)\n}\n" - lang: Java source: |- package com.browserbase.api.example; import com.browserbase.api.client.StagehandClient; import com.browserbase.api.client.okhttp.StagehandOkHttpClient; import com.browserbase.api.models.sessions.SessionNavigateParams; import com.browserbase.api.models.sessions.SessionNavigateResponse; public final class Main { private Main() {} public static void main(String[] args) { StagehandClient client = StagehandOkHttpClient.fromEnv(); SessionNavigateParams params = SessionNavigateParams.builder() .id("c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123") .url("https://example.com") .build(); SessionNavigateResponse response = client.sessions().navigate(params); } } - lang: Kotlin source: |- package com.browserbase.api.example import com.browserbase.api.client.StagehandClient import com.browserbase.api.client.okhttp.StagehandOkHttpClient import com.browserbase.api.models.sessions.SessionNavigateParams import com.browserbase.api.models.sessions.SessionNavigateResponse fun main() { val client: StagehandClient = StagehandOkHttpClient.fromEnv() val params: SessionNavigateParams = SessionNavigateParams.builder() .id("c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123") .url("https://example.com") .build() val response: SessionNavigateResponse = client.sessions().navigate(params) } - lang: Ruby source: >- require "stagehand" stagehand = Stagehand::Client.new( browserbase_api_key: "My Browserbase API Key", browserbase_project_id: "My Browserbase Project ID", model_api_key: "My Model API Key" ) response = stagehand.sessions.navigate("c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123", url: "https://example.com") puts(response) components: schemas: NavigateRequest: type: object properties: url: description: URL to navigate to example: https://example.com type: string options: $ref: '#/components/schemas/NavigateOptions' frameId: description: Target frame ID for the navigation anyOf: - type: string - type: 'null' streamResponse: description: Whether to stream the response via SSE example: true type: boolean required: - url NavigateResponse: type: object properties: success: description: Indicates whether the request was successful type: boolean data: $ref: '#/components/schemas/NavigateResultOutput' required: - success - data additionalProperties: false NavigateOptions: type: object properties: referer: description: Referer header to send with the request type: string timeout: description: Timeout in ms for the navigation example: 30000 type: number waitUntil: description: When to consider navigation complete example: networkidle type: string enum: - load - domcontentloaded - networkidle NavigateResultOutput: type: object properties: result: description: Navigation response (Playwright Response object or null) anyOf: - {} - type: 'null' x-stainless-any: true actionId: description: Action ID for tracking type: string required: - result additionalProperties: false securitySchemes: BrowserbaseApiKey: type: apiKey in: header name: x-bb-api-key description: Browserbase API key for authentication BrowserbaseProjectId: type: apiKey in: header name: x-bb-project-id description: >- Deprecated. Browserbase API keys are now project-scoped, so this header is no longer required. ````