--- title: Devtools --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) [Browser Rendering](https://developers.cloudflare.com/api/typescript/resources/browser_rendering) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Devtools #### DevtoolsSession ##### [List sessions.](https://developers.cloudflare.com/api/typescript/resources/browser_rendering/subresources/devtools/subresources/session/methods/list) client.browserRendering.devtools.session.list(SessionListParams {account\_id, limit, offset } params, RequestOptionsoptions?): [SessionListResponse]() {sessionId, closeReason, closeReasonText, 8 more } GET/accounts/{account\_id}/browser-rendering/devtools/session ##### [Get session details.](https://developers.cloudflare.com/api/typescript/resources/browser_rendering/subresources/devtools/subresources/session/methods/get) client.browserRendering.devtools.session.get(stringsessionID, SessionGetParams {account\_id } params, RequestOptionsoptions?): [SessionGetResponse]() {sessionId, closeReason, closeReasonText, 8 more } | null GET/accounts/{account\_id}/browser-rendering/devtools/session/{session\_id} ##### ModelsExpand Collapse
SessionListResponse = Array<SessionListResponseItem> sessionId: string Session ID. formatuuid Link to this property closeReason?: number Reason code for session closure. Link to this property closeReasonText?: string Human-readable close reason. Link to this property connectionEndTime?: number Connection end time. Link to this property connectionId?: string Connection ID. Link to this property connectionStartTime?: number Connection start time. Link to this property devtoolsFrontendUrl?: string DevTools frontend URL. Link to this property endTime?: number Session end time. Link to this property lastUpdated?: number Last updated timestamp. Link to this property startTime?: number Session start time. Link to this property webSocketDebuggerUrl?: string WebSocket URL for debugging this target. Link to this property
[Link to this property](<#(resource)%20browser_rendering.devtools.session%20%3E%20(model)%20session_list_response%20%3E%20(schema)>)
SessionGetResponse {sessionId, closeReason, closeReasonText, 8 more } sessionId: string Session ID. formatuuid Link to this property closeReason?: number Reason code for session closure. Link to this property closeReasonText?: string Human-readable close reason. Link to this property connectionEndTime?: number Connection end time. Link to this property connectionId?: string Connection ID. Link to this property connectionStartTime?: number Connection start time. Link to this property devtoolsFrontendUrl?: string DevTools frontend URL. Link to this property endTime?: number Session end time. Link to this property lastUpdated?: number Last updated timestamp. Link to this property startTime?: number Session start time. Link to this property webSocketDebuggerUrl?: string WebSocket URL for debugging this target. Link to this property
[Link to this property](<#(resource)%20browser_rendering.devtools.session%20%3E%20(model)%20session_get_response%20%3E%20(schema)>) #### DevtoolsBrowser ##### [Get a browser session ID.](https://developers.cloudflare.com/api/typescript/resources/browser_rendering/subresources/devtools/subresources/browser/methods/create) client.browserRendering.devtools.browser.create(BrowserCreateParams {account\_id, keep\_alive, lab, 4 more } params, RequestOptionsoptions?): [BrowserCreateResponse]() {sessionId, webSocketDebuggerUrl } POST/accounts/{account\_id}/browser-rendering/devtools/browser ##### [Close browser session.](https://developers.cloudflare.com/api/typescript/resources/browser_rendering/subresources/devtools/subresources/browser/methods/delete) client.browserRendering.devtools.browser.delete(stringsessionID, BrowserDeleteParams {account\_id } params, RequestOptionsoptions?): [BrowserDeleteResponse]() {status } DELETE/accounts/{account\_id}/browser-rendering/devtools/browser/{session\_id} ##### [Get browser version metadata.](https://developers.cloudflare.com/api/typescript/resources/browser_rendering/subresources/devtools/subresources/browser/methods/version) client.browserRendering.devtools.browser.version(stringsessionID, BrowserVersionParams {account\_id } params, RequestOptionsoptions?): [BrowserVersionResponse]() {Browser, Protocol-Version, User-Agent, 3 more } GET/accounts/{account\_id}/browser-rendering/devtools/browser/{session\_id}/json/version ##### [Get Chrome DevTools Protocol schema.](https://developers.cloudflare.com/api/typescript/resources/browser_rendering/subresources/devtools/subresources/browser/methods/protocol) client.browserRendering.devtools.browser.protocol(stringsessionID, BrowserProtocolParams {account\_id } params, RequestOptionsoptions?): [BrowserProtocolResponse]() {domains, version } GET/accounts/{account\_id}/browser-rendering/devtools/browser/{session\_id}/json/protocol ##### ModelsExpand Collapse
BrowserCreateResponse {sessionId, webSocketDebuggerUrl } sessionId: string Browser session ID. Link to this property webSocketDebuggerUrl?: string WebSocket URL for the session. Link to this property
[Link to this property](<#(resource)%20browser_rendering.devtools.browser%20%3E%20(model)%20browser_create_response%20%3E%20(schema)>)
BrowserDeleteResponse {status }
status: "closing"| "closed" One of the following: "closing" Link to this property "closed" Link to this property
Link to this property
[Link to this property](<#(resource)%20browser_rendering.devtools.browser%20%3E%20(model)%20browser_delete_response%20%3E%20(schema)>)
BrowserVersionResponse {Browser, Protocol-Version, User-Agent, 3 more } Browser: string Browser name and version. Link to this property "Protocol-Version": string Chrome DevTools Protocol version. Link to this property "User-Agent": string User agent string. Link to this property "V8-Version": string V8 JavaScript engine version. Link to this property "WebKit-Version": string WebKit version. Link to this property webSocketDebuggerUrl: string WebSocket URL for debugging the browser. Link to this property
[Link to this property](<#(resource)%20browser_rendering.devtools.browser%20%3E%20(model)%20browser_version_response%20%3E%20(schema)>)
BrowserProtocolResponse {domains, version }
domains: Array<Domain> List of protocol domains. domain: string Domain name. Link to this property commands?: Array<Record<string, unknown>> Available commands. Link to this property dependencies?: Array<string> Domain dependencies. Link to this property events?: Array<Record<string, unknown>> Available events. Link to this property experimental?: boolean Whether this domain is experimental. Link to this property types?: Array<Record<string, unknown>> Type definitions. Link to this property
Link to this property
version?: Version {major, minor } Protocol version. major: string Major version. Link to this property minor: string Minor version. Link to this property
Link to this property
[Link to this property](<#(resource)%20browser_rendering.devtools.browser%20%3E%20(model)%20browser_protocol_response%20%3E%20(schema)>) #### DevtoolsBrowserLive View ##### [Mint live view URLs for a browser session](https://developers.cloudflare.com/api/typescript/resources/browser_rendering/subresources/devtools/subresources/browser/subresources/live_view/methods/create) client.browserRendering.devtools.browser.liveView.create(stringsessionID, LiveViewCreateParams {account\_id, expiresInMs, guardrails, 2 more } params, RequestOptionsoptions?): [LiveViewCreateResponse]() {id, devtoolsFrontendUrl, options, webSocketDebuggerUrl } POST/accounts/{account\_id}/browser-rendering/devtools/browser/{session\_id}/live\_view ##### ModelsExpand Collapse
LiveViewCreateResponse {id, devtoolsFrontendUrl, options, webSocketDebuggerUrl } id: string Target ID Link to this property devtoolsFrontendUrl: string URL to open the live view in a browser formaturi Link to this property
options: Options {mode, guardrails }
mode: "devtools"| "tab"| "full" UI mode for the live view One of the following: "devtools" Link to this property "tab" Link to this property "full" Link to this property
Link to this property
guardrails?: Guardrails {mode } Connection guardrails applied to this link mode: "readonly" Link to this property
Link to this property
Link to this property webSocketDebuggerUrl: string WebSocket URL for CDP connection formaturi Link to this property
[Link to this property](<#(resource)%20browser_rendering.devtools.browser.live_view%20%3E%20(model)%20live_view_create_response%20%3E%20(schema)>) #### DevtoolsBrowserPage #### DevtoolsBrowserTargets ##### [Open a new browser tab.](https://developers.cloudflare.com/api/typescript/resources/browser_rendering/subresources/devtools/subresources/browser/subresources/targets/methods/create) client.browserRendering.devtools.browser.targets.create(stringsessionID, TargetCreateParams {account\_id, liveViewUrlExpiresInMs, url } params, RequestOptionsoptions?): [TargetCreateResponse]() {id, type, url, 4 more } PUT/accounts/{account\_id}/browser-rendering/devtools/browser/{session\_id}/json/new ##### [List targets.](https://developers.cloudflare.com/api/typescript/resources/browser_rendering/subresources/devtools/subresources/browser/subresources/targets/methods/list) client.browserRendering.devtools.browser.targets.list(stringsessionID, TargetListParams {account\_id, liveViewUrlExpiresInMs } params, RequestOptionsoptions?): [TargetListResponse]() {id, type, url, 4 more } GET/accounts/{account\_id}/browser-rendering/devtools/browser/{session\_id}/json/list ##### [Get a target by ID.](https://developers.cloudflare.com/api/typescript/resources/browser_rendering/subresources/devtools/subresources/browser/subresources/targets/methods/get) client.browserRendering.devtools.browser.targets.get(stringtargetID, TargetGetParams {account\_id, session\_id } params, RequestOptionsoptions?): [TargetGetResponse]() {id, type, url, 4 more } GET/accounts/{account\_id}/browser-rendering/devtools/browser/{session\_id}/json/list/{target\_id} ##### [Activate a browser target.](https://developers.cloudflare.com/api/typescript/resources/browser_rendering/subresources/devtools/subresources/browser/subresources/targets/methods/activate) client.browserRendering.devtools.browser.targets.activate(stringtargetID, TargetActivateParams {account\_id, session\_id } params, RequestOptionsoptions?): [TargetActivateResponse]() {message } GET/accounts/{account\_id}/browser-rendering/devtools/browser/{session\_id}/json/activate/{target\_id} ##### [Close a browser target.](https://developers.cloudflare.com/api/typescript/resources/browser_rendering/subresources/devtools/subresources/browser/subresources/targets/methods/close) client.browserRendering.devtools.browser.targets.close(stringtargetID, TargetCloseParams {account\_id, session\_id } params, RequestOptionsoptions?): [TargetCloseResponse]() {message } GET/accounts/{account\_id}/browser-rendering/devtools/browser/{session\_id}/json/close/{target\_id} ##### ModelsExpand Collapse
TargetCreateResponse {id, type, url, 4 more } id: string Target ID. Link to this property type: string Target type (page, background\_page, worker, etc.). Link to this property url: string URL of the target. Link to this property description?: string Target description. Link to this property devtoolsFrontendUrl?: string DevTools frontend URL. Link to this property title?: string Title of the target. Link to this property webSocketDebuggerUrl?: string WebSocket URL for debugging this target. Link to this property
[Link to this property](<#(resource)%20browser_rendering.devtools.browser.targets%20%3E%20(model)%20target_create_response%20%3E%20(schema)>)
TargetListResponse = Array<TargetListResponseItem> id: string Target ID. Link to this property type: string Target type (page, background\_page, worker, etc.). Link to this property url: string URL of the target. Link to this property description?: string Target description. Link to this property devtoolsFrontendUrl?: string DevTools frontend URL. Link to this property title?: string Title of the target. Link to this property webSocketDebuggerUrl?: string WebSocket URL for debugging this target. Link to this property
[Link to this property](<#(resource)%20browser_rendering.devtools.browser.targets%20%3E%20(model)%20target_list_response%20%3E%20(schema)>)
TargetGetResponse {id, type, url, 4 more } id: string Target ID. Link to this property type: string Target type (page, background\_page, worker, etc.). Link to this property url: string URL of the target. Link to this property description?: string Target description. Link to this property devtoolsFrontendUrl?: string DevTools frontend URL. Link to this property title?: string Title of the target. Link to this property webSocketDebuggerUrl?: string WebSocket URL for debugging this target. Link to this property
[Link to this property](<#(resource)%20browser_rendering.devtools.browser.targets%20%3E%20(model)%20target_get_response%20%3E%20(schema)>)
TargetActivateResponse {message } message: string Target activated. Link to this property
[Link to this property](<#(resource)%20browser_rendering.devtools.browser.targets%20%3E%20(model)%20target_activate_response%20%3E%20(schema)>)
TargetCloseResponse {message } message: string Target is closing. Link to this property
[Link to this property](<#(resource)%20browser_rendering.devtools.browser.targets%20%3E%20(model)%20target_close_response%20%3E%20(schema)>)