@browserless.io/browserless 2.29.0 → 2.30.1

package/static/docs/swagger.min.json

@@ -280,14 +280,14 @@
                 "length": {
                   "type": "number"
                 },
-                "__@toStringTag@118534": {
+                "__@toStringTag@14939": {
                   "type": "string",
                   "const": "Uint8Array"
                 }
               },
               "required": [
                 "BYTES_PER_ELEMENT",
-                "__@toStringTag@118534",
+                "__@toStringTag@14939",
                 "buffer",
                 "byteLength",
                 "byteOffset",
@@ -322,13 +322,13 @@
         "byteLength": {
           "type": "number"
         },
-        "__@toStringTag@118534": {
+        "__@toStringTag@14939": {
           "type": "string"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@toStringTag@118534",
+        "__@toStringTag@14939",
         "byteLength"
       ]
     },
@@ -338,18 +338,18 @@
         "byteLength": {
           "type": "number"
         },
-        "__@species@118572": {
+        "__@species@14977": {
           "$ref": "#/definitions/SharedArrayBuffer"
         },
-        "__@toStringTag@118534": {
+        "__@toStringTag@14939": {
           "type": "string",
           "const": "SharedArrayBuffer"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@species@118572",
-        "__@toStringTag@118534",
+        "__@species@14977",
+        "__@toStringTag@14939",
         "byteLength"
       ]
     },
@@ -1001,7 +1001,7 @@
   },
   "info": {
     "title": "Browserless",
-    "version": "2.29.0",
+    "version": "2.30.1",
     "x-logo": {
       "altText": "browserless logo",
       "url": "./docs/browserless-logo-inline.svg"
@@ -3256,10 +3256,10 @@
         ]
       }
     },
-    "/devtools/browser/*": {
-      "get": {
+    "/chromium/content": {
+      "post": {
         "definitions": {},
-        "description": "Connect to an already-running Chromium process with a library like\npuppeteer, or others, that work over chrome-devtools-protocol. Chromium\nmust already be launched in order to not return a 404.",
+        "description": "A JSON-based API. Given a \"url\" or \"html\" field, runs and returns HTML content after the page has loaded and JavaScript has parsed.\n\n**Note:** This endpoint is also available at: `/content` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -3273,7 +3273,6 @@
             "in": "query",
             "name": "launch",
             "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
               "anyOf": [
                 {
                   "$ref": "#/definitions/CDPLaunchOptions"
@@ -3310,11 +3309,208 @@
           }
         ],
         "requestBody": {
-          "content": {}
+          "content": {
+            "application/json": {
+              "schema": {
+                "properties": {
+                  "addScriptTag": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/FrameAddScriptTagOptions"
+                    }
+                  },
+                  "addStyleTag": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/FrameAddStyleTagOptions"
+                    }
+                  },
+                  "authenticate": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/definitions/Credentials"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "bestAttempt": {
+                    "description": "When bestAttempt is set to true, browserless attempt to proceed\nwhen \"awaited\" events fail or timeout. This includes things like\ngoto, waitForSelector, and more.",
+                    "type": "boolean"
+                  },
+                  "cookies": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/CookieParam"
+                    }
+                  },
+                  "emulateMediaType": {
+                    "type": "string"
+                  },
+                  "gotoOptions": {
+                    "$ref": "#/definitions/GoToOptions"
+                  },
+                  "html": {
+                    "type": "string"
+                  },
+                  "rejectRequestPattern": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "rejectResourceTypes": {
+                    "type": "array",
+                    "items": {
+                      "enum": [
+                        "cspviolationreport",
+                        "document",
+                        "eventsource",
+                        "fetch",
+                        "font",
+                        "image",
+                        "manifest",
+                        "media",
+                        "other",
+                        "ping",
+                        "prefetch",
+                        "preflight",
+                        "script",
+                        "signedexchange",
+                        "stylesheet",
+                        "texttrack",
+                        "websocket",
+                        "xhr"
+                      ],
+                      "type": "string"
+                    }
+                  },
+                  "requestInterceptors": {
+                    "type": "array",
+                    "items": {
+                      "description": "An array of patterns (using `req.url().match(r.pattern)` to match) and their\ncorresponding responses to use in order to fulfill those requests.",
+                      "type": "object",
+                      "properties": {
+                        "pattern": {
+                          "description": "An array of patterns (using `req.url().match(r.pattern)` to match) and their\ncorresponding responses to use in order to fulfill those requests.",
+                          "type": "string"
+                        },
+                        "response": {
+                          "$ref": "#/definitions/Partial<ResponseForRequest>"
+                        }
+                      },
+                      "additionalProperties": false,
+                      "required": [
+                        "pattern",
+                        "response"
+                      ]
+                    }
+                  },
+                  "setExtraHTTPHeaders": {
+                    "$ref": "#/definitions/Record<string,string>"
+                  },
+                  "setJavaScriptEnabled": {
+                    "description": "Whether or not to allow JavaScript to run on the page.",
+                    "type": "boolean"
+                  },
+                  "url": {
+                    "type": "string"
+                  },
+                  "userAgent": {
+                    "type": "string"
+                  },
+                  "viewport": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/definitions/Viewport"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "waitForEvent": {
+                    "type": "object",
+                    "properties": {
+                      "event": {
+                        "type": "string"
+                      },
+                      "timeout": {
+                        "type": "number"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "event"
+                    ]
+                  },
+                  "waitForFunction": {
+                    "type": "object",
+                    "properties": {
+                      "fn": {
+                        "description": "The function, or statement, to be evaluated in browser context",
+                        "type": "string"
+                      },
+                      "polling": {
+                        "description": "An interval at which the pageFunction is executed, defaults to raf.\nIf polling is a number, then it is treated as an interval in milliseconds\nat which the function would be executed. If polling is a string,\nthen it can be one of the following values: \"raf\" or \"mutation\"",
+                        "type": [
+                          "string",
+                          "number"
+                        ]
+                      },
+                      "timeout": {
+                        "description": "Maximum time to wait for in milliseconds. Defaults to 30000 (30 seconds).\nPass 0 to disable timeout.",
+                        "type": "number"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "fn"
+                    ]
+                  },
+                  "waitForSelector": {
+                    "type": "object",
+                    "properties": {
+                      "hidden": {
+                        "type": "boolean"
+                      },
+                      "selector": {
+                        "type": "string"
+                      },
+                      "timeout": {
+                        "type": "number"
+                      },
+                      "visible": {
+                        "type": "boolean"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "selector"
+                    ]
+                  },
+                  "waitForTimeout": {
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              }
+            }
+          }
         },
         "responses": {
-          "101": {
-            "description": "Indicates successful WebSocket upgrade."
+          "200": {
+            "content": {
+              "text/html": {
+                "schema": {
+                  "description": "An HTML payload of the website or HTML after JavaScript\nparsing and execution.",
+                  "type": "string",
+                  "$schema": "http://json-schema.org/draft-07/schema#"
+                }
+              }
+            },
+            "description": "An HTML payload of the website or HTML after JavaScript\nparsing and execution."
           },
           "400": {
             "code": 400,
@@ -3347,16 +3543,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/devtools/browser/*",
+        "summary": "/chromium/content",
         "tags": [
-          "Browser WebSocket APIs"
+          "Browser REST APIs"
         ]
       }
     },
-    "/chrome": {
-      "get": {
+    "/chromium/download": {
+      "post": {
         "definitions": {},
-        "description": "Launch and connect to Chromium with a library like puppeteer or others that work over chrome-devtools-protocol.",
+        "description": "A JSON or JavaScript content-type API for returning files Chrome has downloaded during\nthe execution of puppeteer code, which is ran inside context of the browser.\nBrowserless sets up a blank page, a fresh download directory, injects your puppeteer code, and then executes it.\nYou can load external libraries via the \"import\" syntax, and import ESM-style modules\nthat are written for execution inside of the browser. Once your script is finished, any\ndownloaded files from Chromium are returned back with the appropriate content-type header.\n\n**Note:** This endpoint is also available at: `/download` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -3407,11 +3603,30 @@
           }
         ],
         "requestBody": {
-          "content": {}
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/definitions/JSONSchema"
+              }
+            },
+            "application/javascript": {
+              "schema": {
+                "type": "string"
+              }
+            }
+          }
         },
         "responses": {
-          "101": {
-            "description": "Indicates successful WebSocket upgrade."
+          "200": {
+            "content": {
+              "*/*": {
+                "schema": {
+                  "description": "Responses are determined by the returned value of the downloads\nthemselves, so there isn't a static response type for this API.",
+                  "$schema": "http://json-schema.org/draft-07/schema#"
+                }
+              }
+            },
+            "description": "Responses are determined by the returned value of the downloads\nthemselves, so there isn't a static response type for this API."
           },
           "400": {
             "code": 400,
@@ -3444,16 +3659,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/chrome",
+        "summary": "/chromium/download",
         "tags": [
-          "Browser WebSocket APIs"
+          "Browser REST APIs"
         ]
       }
     },
-    "/devtools/page/*": {
-      "get": {
+    "/chromium/function": {
+      "post": {
         "definitions": {},
-        "description": "Connect to an existing page in Chromium with a library like\nchrome-remote-interface or others that work the page websocketDebugger\nURL. You can get this unique URL by calling the /json/list API\nor by finding the page's unique ID from your library of choice.",
+        "description": "A JSON or JavaScript content-type API for running puppeteer code in the browser's context.\nBrowserless sets up a blank page, injects your puppeteer code, and runs it.\nYou can optionally load external libraries via the \"import\" module that are meant for browser usage.\nValues returned from the function are checked and an appropriate content-type and response is sent back\nto your HTTP call.\n\n**Note:** This endpoint is also available at: `/function` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -3504,108 +3719,30 @@
           }
         ],
         "requestBody": {
-          "content": {}
-        },
-        "responses": {
-          "101": {
-            "description": "Indicates successful WebSocket upgrade."
-          },
-          "400": {
-            "code": 400,
-            "description": "The request contains errors or didn't properly encode content.",
-            "message": "HTTP/1.1 400 Bad Request"
-          },
-          "401": {
-            "code": 401,
-            "description": "The request is missing, or contains bad, authorization credentials.",
-            "message": "HTTP/1.1 401 Unauthorized"
-          },
-          "404": {
-            "code": 404,
-            "description": "Resource couldn't be found.",
-            "message": "HTTP/1.1 404 Not Found"
-          },
-          "408": {
-            "code": 408,
-            "description": "The request took has taken too long to process.",
-            "message": "HTTP/1.1 408 Request Timeout"
-          },
-          "429": {
-            "code": 429,
-            "description": "Too many requests are currently being processed.",
-            "message": "HTTP/1.1 429 Too Many Requests"
-          },
-          "500": {
-            "code": 500,
-            "description": "An internal error occurred when handling the request.",
-            "message": "HTTP/1.1 500 Internal Server Error"
-          }
-        },
-        "summary": "/devtools/page/*",
-        "tags": [
-          "Browser WebSocket APIs"
-        ]
-      }
-    },
-    "/chrome/playwright": {
-      "get": {
-        "definitions": {},
-        "description": "Connect to Chromium with any playwright style library.",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "blockAds",
-            "schema": {
-              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
-              "type": "boolean"
-            }
-          },
-          {
-            "in": "query",
-            "name": "launch",
-            "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/BrowserServerOptions"
-                },
-                {
-                  "type": "string"
-                }
-              ]
-            }
-          },
-          {
-            "in": "query",
-            "name": "timeout",
-            "schema": {
-              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
-              "type": "number"
-            }
-          },
-          {
-            "in": "query",
-            "name": "token",
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
-          {
-            "in": "query",
-            "name": "trackingId",
-            "schema": {
-              "description": "Custom session identifier",
-              "type": "string"
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/definitions/JSONSchema"
+              }
+            },
+            "application/javascript": {
+              "schema": {
+                "type": "string"
+              }
             }
           }
-        ],
-        "requestBody": {
-          "content": {}
         },
         "responses": {
-          "101": {
-            "description": "Indicates successful WebSocket upgrade."
+          "200": {
+            "content": {
+              "*/*": {
+                "schema": {
+                  "description": "Responses are determined by the returned value of the function\nitself. Binary responses (PDF's, screenshots) are returned back\nas binary data, and primitive JavaScript values are returned back\nby type (HTML data is \"text/html\", Objects are \"application/json\")",
+                  "$schema": "http://json-schema.org/draft-07/schema#"
+                }
+              }
+            },
+            "description": "Responses are determined by the returned value of the function\nitself. Binary responses (PDF's, screenshots) are returned back\nas binary data, and primitive JavaScript values are returned back\nby type (HTML data is \"text/html\", Objects are \"application/json\")"
           },
           "400": {
             "code": 400,
@@ -3638,16 +3775,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/chrome/playwright",
+        "summary": "/chromium/function",
         "tags": [
-          "Browser WebSocket APIs"
+          "Browser REST APIs"
         ]
       }
     },
-    "/content /chromium/content": {
+    "/chromium/pdf": {
       "post": {
         "definitions": {},
-        "description": "A JSON-based API. Given a \"url\" or \"html\" field, runs and returns HTML content after the page has loaded and JavaScript has parsed.",
+        "description": "A JSON-based API for getting a PDF binary from either a supplied\n\"url\" or \"html\" payload in your request. Many options exist for\ninjecting cookies, request interceptors, user-agents and waiting for\nselectors, timers and more.\n\n**Note:** This endpoint is also available at: `/pdf` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -3661,6 +3798,7 @@
             "in": "query",
             "name": "launch",
             "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
               "anyOf": [
                 {
                   "$ref": "#/definitions/CDPLaunchOptions"
@@ -3742,6 +3880,9 @@
                   "html": {
                     "type": "string"
                   },
+                  "options": {
+                    "$ref": "#/definitions/PDFOptions"
+                  },
                   "rejectRequestPattern": {
                     "type": "array",
                     "items": {
@@ -3799,7 +3940,6 @@
                     "$ref": "#/definitions/Record<string,string>"
                   },
                   "setJavaScriptEnabled": {
-                    "description": "Whether or not to allow JavaScript to run on the page.",
                     "type": "boolean"
                   },
                   "url": {
@@ -3890,15 +4030,15 @@
         "responses": {
           "200": {
             "content": {
-              "text/html": {
+              "application/pdf": {
                 "schema": {
-                  "description": "An HTML payload of the website or HTML after JavaScript\nparsing and execution.",
+                  "description": "Responds with an application/pdf content-type and a binary PDF",
                   "type": "string",
                   "$schema": "http://json-schema.org/draft-07/schema#"
                 }
               }
             },
-            "description": "An HTML payload of the website or HTML after JavaScript\nparsing and execution."
+            "description": "Responds with an application/pdf content-type and a binary PDF"
           },
           "400": {
             "code": 400,
@@ -3931,16 +4071,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/content /chromium/content",
+        "summary": "/chromium/pdf",
         "tags": [
           "Browser REST APIs"
         ]
       }
     },
-    "/download /chromium/download": {
+    "/chromium/performance": {
       "post": {
         "definitions": {},
-        "description": "A JSON or JavaScript content-type API for returning files Chrome has downloaded during\nthe execution of puppeteer code, which is ran inside context of the browser.\nBrowserless sets up a blank page, a fresh download directory, injects your puppeteer code, and then executes it.\nYou can load external libraries via the \"import\" syntax, and import ESM-style modules\nthat are written for execution inside of the browser. Once your script is finished, any\ndownloaded files from Chromium are returned back with the appropriate content-type header.",
+        "description": "Run lighthouse performance audits with a supplied \"url\" in your JSON payload.\n\n**Note:** This endpoint is also available at: `/performance` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -3994,12 +4134,25 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/definitions/JSONSchema"
-              }
-            },
-            "application/javascript": {
-              "schema": {
-                "type": "string"
+                "properties": {
+                  "budgets": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {},
+                      "additionalProperties": true
+                    }
+                  },
+                  "config": {
+                    "type": "object",
+                    "properties": {},
+                    "additionalProperties": true
+                  },
+                  "url": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
               }
             }
           }
@@ -4007,14 +4160,17 @@
         "responses": {
           "200": {
             "content": {
-              "*/*": {
+              "application/json": {
                 "schema": {
-                  "description": "Responses are determined by the returned value of the downloads\nthemselves, so there isn't a static response type for this API.",
+                  "description": "The response of the lighthouse stats. Response objects are\ndetermined by the type of budgets and config in the POST\nJSON body",
+                  "type": "object",
+                  "properties": {},
+                  "additionalProperties": true,
                   "$schema": "http://json-schema.org/draft-07/schema#"
                 }
               }
             },
-            "description": "Responses are determined by the returned value of the downloads\nthemselves, so there isn't a static response type for this API."
+            "description": "The response of the lighthouse stats. Response objects are\ndetermined by the type of budgets and config in the POST\nJSON body"
           },
           "400": {
             "code": 400,
@@ -4047,16 +4203,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/download /chromium/download",
+        "summary": "/chromium/performance",
         "tags": [
           "Browser REST APIs"
         ]
       }
     },
-    "/function /chromium/function": {
+    "/chromium/scrape": {
       "post": {
         "definitions": {},
-        "description": "A JSON or JavaScript content-type API for running puppeteer code in the browser's context.\nBrowserless sets up a blank page, injects your puppeteer code, and runs it.\nYou can optionally load external libraries via the \"import\" module that are meant for browser usage.\nValues returned from the function are checked and an appropriate content-type and response is sent back\nto your HTTP call.",
+        "description": "A JSON-based API that returns text, html, and meta-data from a given list of selectors.\nDebugging information is available by sending in the appropriate flags in the \"debugOpts\"\nproperty. Responds with an array of JSON objects.\n\n**Note:** This endpoint is also available at: `/scrape` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -4070,123 +4226,6 @@
             "in": "query",
             "name": "launch",
             "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/CDPLaunchOptions"
-                },
-                {
-                  "type": "string"
-                }
-              ]
-            }
-          },
-          {
-            "in": "query",
-            "name": "timeout",
-            "schema": {
-              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
-              "type": "number"
-            }
-          },
-          {
-            "in": "query",
-            "name": "token",
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
-          {
-            "in": "query",
-            "name": "trackingId",
-            "schema": {
-              "description": "Custom session identifier",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/definitions/JSONSchema"
-              }
-            },
-            "application/javascript": {
-              "schema": {
-                "type": "string"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "*/*": {
-                "schema": {
-                  "description": "Responses are determined by the returned value of the function\nitself. Binary responses (PDF's, screenshots) are returned back\nas binary data, and primitive JavaScript values are returned back\nby type (HTML data is \"text/html\", Objects are \"application/json\")",
-                  "$schema": "http://json-schema.org/draft-07/schema#"
-                }
-              }
-            },
-            "description": "Responses are determined by the returned value of the function\nitself. Binary responses (PDF's, screenshots) are returned back\nas binary data, and primitive JavaScript values are returned back\nby type (HTML data is \"text/html\", Objects are \"application/json\")"
-          },
-          "400": {
-            "code": 400,
-            "description": "The request contains errors or didn't properly encode content.",
-            "message": "HTTP/1.1 400 Bad Request"
-          },
-          "401": {
-            "code": 401,
-            "description": "The request is missing, or contains bad, authorization credentials.",
-            "message": "HTTP/1.1 401 Unauthorized"
-          },
-          "404": {
-            "code": 404,
-            "description": "Resource couldn't be found.",
-            "message": "HTTP/1.1 404 Not Found"
-          },
-          "408": {
-            "code": 408,
-            "description": "The request took has taken too long to process.",
-            "message": "HTTP/1.1 408 Request Timeout"
-          },
-          "429": {
-            "code": 429,
-            "description": "Too many requests are currently being processed.",
-            "message": "HTTP/1.1 429 Too Many Requests"
-          },
-          "500": {
-            "code": 500,
-            "description": "An internal error occurred when handling the request.",
-            "message": "HTTP/1.1 500 Internal Server Error"
-          }
-        },
-        "summary": "/function /chromium/function",
-        "tags": [
-          "Browser REST APIs"
-        ]
-      }
-    },
-    "/pdf /chromium/pdf": {
-      "post": {
-        "definitions": {},
-        "description": "A JSON-based API for getting a PDF binary from either a supplied\n\"url\" or \"html\" payload in your request. Many options exist for\ninjecting cookies, request interceptors, user-agents and waiting for\nselectors, timers and more.",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "blockAds",
-            "schema": {
-              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
-              "type": "boolean"
-            }
-          },
-          {
-            "in": "query",
-            "name": "launch",
-            "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
               "anyOf": [
                 {
                   "$ref": "#/definitions/CDPLaunchOptions"
@@ -4259,6 +4298,15 @@
                       "$ref": "#/definitions/CookieParam"
                     }
                   },
+                  "debugOpts": {
+                    "$ref": "#/definitions/ScrapeDebugOptions"
+                  },
+                  "elements": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/ScrapeElementSelector"
+                    }
+                  },
                   "emulateMediaType": {
                     "type": "string"
                   },
@@ -4268,9 +4316,6 @@
                   "html": {
                     "type": "string"
                   },
-                  "options": {
-                    "$ref": "#/definitions/PDFOptions"
-                  },
                   "rejectRequestPattern": {
                     "type": "array",
                     "items": {
@@ -4415,445 +4460,12 @@
             }
           }
         },
-        "responses": {
-          "200": {
-            "content": {
-              "application/pdf": {
-                "schema": {
-                  "description": "Responds with an application/pdf content-type and a binary PDF",
-                  "type": "string",
-                  "$schema": "http://json-schema.org/draft-07/schema#"
-                }
-              }
-            },
-            "description": "Responds with an application/pdf content-type and a binary PDF"
-          },
-          "400": {
-            "code": 400,
-            "description": "The request contains errors or didn't properly encode content.",
-            "message": "HTTP/1.1 400 Bad Request"
-          },
-          "401": {
-            "code": 401,
-            "description": "The request is missing, or contains bad, authorization credentials.",
-            "message": "HTTP/1.1 401 Unauthorized"
-          },
-          "404": {
-            "code": 404,
-            "description": "Resource couldn't be found.",
-            "message": "HTTP/1.1 404 Not Found"
-          },
-          "408": {
-            "code": 408,
-            "description": "The request took has taken too long to process.",
-            "message": "HTTP/1.1 408 Request Timeout"
-          },
-          "429": {
-            "code": 429,
-            "description": "Too many requests are currently being processed.",
-            "message": "HTTP/1.1 429 Too Many Requests"
-          },
-          "500": {
-            "code": 500,
-            "description": "An internal error occurred when handling the request.",
-            "message": "HTTP/1.1 500 Internal Server Error"
-          }
-        },
-        "summary": "/pdf /chromium/pdf",
-        "tags": [
-          "Browser REST APIs"
-        ]
-      }
-    },
-    "/performance /chromium/performance": {
-      "post": {
-        "definitions": {},
-        "description": "Run lighthouse performance audits with a supplied \"url\" in your JSON payload.",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "blockAds",
-            "schema": {
-              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
-              "type": "boolean"
-            }
-          },
-          {
-            "in": "query",
-            "name": "launch",
-            "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/CDPLaunchOptions"
-                },
-                {
-                  "type": "string"
-                }
-              ]
-            }
-          },
-          {
-            "in": "query",
-            "name": "timeout",
-            "schema": {
-              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
-              "type": "number"
-            }
-          },
-          {
-            "in": "query",
-            "name": "token",
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
-          {
-            "in": "query",
-            "name": "trackingId",
-            "schema": {
-              "description": "Custom session identifier",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "properties": {
-                  "budgets": {
-                    "type": "array",
-                    "items": {
-                      "type": "object",
-                      "properties": {},
-                      "additionalProperties": true
-                    }
-                  },
-                  "config": {
-                    "type": "object",
-                    "properties": {},
-                    "additionalProperties": true
-                  },
-                  "url": {
-                    "type": "string"
-                  }
-                },
-                "type": "object"
-              }
-            }
-          }
-        },
         "responses": {
           "200": {
             "content": {
               "application/json": {
                 "schema": {
-                  "description": "The response of the lighthouse stats. Response objects are\ndetermined by the type of budgets and config in the POST\nJSON body",
-                  "type": "object",
-                  "properties": {},
-                  "additionalProperties": true,
-                  "$schema": "http://json-schema.org/draft-07/schema#"
-                }
-              }
-            },
-            "description": "The response of the lighthouse stats. Response objects are\ndetermined by the type of budgets and config in the POST\nJSON body"
-          },
-          "400": {
-            "code": 400,
-            "description": "The request contains errors or didn't properly encode content.",
-            "message": "HTTP/1.1 400 Bad Request"
-          },
-          "401": {
-            "code": 401,
-            "description": "The request is missing, or contains bad, authorization credentials.",
-            "message": "HTTP/1.1 401 Unauthorized"
-          },
-          "404": {
-            "code": 404,
-            "description": "Resource couldn't be found.",
-            "message": "HTTP/1.1 404 Not Found"
-          },
-          "408": {
-            "code": 408,
-            "description": "The request took has taken too long to process.",
-            "message": "HTTP/1.1 408 Request Timeout"
-          },
-          "429": {
-            "code": 429,
-            "description": "Too many requests are currently being processed.",
-            "message": "HTTP/1.1 429 Too Many Requests"
-          },
-          "500": {
-            "code": 500,
-            "description": "An internal error occurred when handling the request.",
-            "message": "HTTP/1.1 500 Internal Server Error"
-          }
-        },
-        "summary": "/performance /chromium/performance",
-        "tags": [
-          "Browser REST APIs"
-        ]
-      }
-    },
-    "/scrape /chromium/scrape": {
-      "post": {
-        "definitions": {},
-        "description": "A JSON-based API that returns text, html, and meta-data from a given list of selectors.\nDebugging information is available by sending in the appropriate flags in the \"debugOpts\"\nproperty. Responds with an array of JSON objects.",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "blockAds",
-            "schema": {
-              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
-              "type": "boolean"
-            }
-          },
-          {
-            "in": "query",
-            "name": "launch",
-            "schema": {
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/CDPLaunchOptions"
-                },
-                {
-                  "type": "string"
-                }
-              ]
-            }
-          },
-          {
-            "in": "query",
-            "name": "timeout",
-            "schema": {
-              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
-              "type": "number"
-            }
-          },
-          {
-            "in": "query",
-            "name": "token",
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
-          {
-            "in": "query",
-            "name": "trackingId",
-            "schema": {
-              "description": "Custom session identifier",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "properties": {
-                  "addScriptTag": {
-                    "type": "array",
-                    "items": {
-                      "$ref": "#/definitions/FrameAddScriptTagOptions"
-                    }
-                  },
-                  "addStyleTag": {
-                    "type": "array",
-                    "items": {
-                      "$ref": "#/definitions/FrameAddStyleTagOptions"
-                    }
-                  },
-                  "authenticate": {
-                    "anyOf": [
-                      {
-                        "$ref": "#/definitions/Credentials"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "bestAttempt": {
-                    "description": "When bestAttempt is set to true, browserless attempt to proceed\nwhen \"awaited\" events fail or timeout. This includes things like\ngoto, waitForSelector, and more.",
-                    "type": "boolean"
-                  },
-                  "cookies": {
-                    "type": "array",
-                    "items": {
-                      "$ref": "#/definitions/CookieParam"
-                    }
-                  },
-                  "debugOpts": {
-                    "$ref": "#/definitions/ScrapeDebugOptions"
-                  },
-                  "elements": {
-                    "type": "array",
-                    "items": {
-                      "$ref": "#/definitions/ScrapeElementSelector"
-                    }
-                  },
-                  "emulateMediaType": {
-                    "type": "string"
-                  },
-                  "gotoOptions": {
-                    "$ref": "#/definitions/GoToOptions"
-                  },
-                  "html": {
-                    "type": "string"
-                  },
-                  "rejectRequestPattern": {
-                    "type": "array",
-                    "items": {
-                      "type": "string"
-                    }
-                  },
-                  "rejectResourceTypes": {
-                    "type": "array",
-                    "items": {
-                      "enum": [
-                        "cspviolationreport",
-                        "document",
-                        "eventsource",
-                        "fetch",
-                        "font",
-                        "image",
-                        "manifest",
-                        "media",
-                        "other",
-                        "ping",
-                        "prefetch",
-                        "preflight",
-                        "script",
-                        "signedexchange",
-                        "stylesheet",
-                        "texttrack",
-                        "websocket",
-                        "xhr"
-                      ],
-                      "type": "string"
-                    }
-                  },
-                  "requestInterceptors": {
-                    "type": "array",
-                    "items": {
-                      "description": "An array of patterns (using `req.url().match(r.pattern)` to match) and their\ncorresponding responses to use in order to fulfill those requests.",
-                      "type": "object",
-                      "properties": {
-                        "pattern": {
-                          "description": "An array of patterns (using `req.url().match(r.pattern)` to match) and their\ncorresponding responses to use in order to fulfill those requests.",
-                          "type": "string"
-                        },
-                        "response": {
-                          "$ref": "#/definitions/Partial<ResponseForRequest>"
-                        }
-                      },
-                      "additionalProperties": false,
-                      "required": [
-                        "pattern",
-                        "response"
-                      ]
-                    }
-                  },
-                  "setExtraHTTPHeaders": {
-                    "$ref": "#/definitions/Record<string,string>"
-                  },
-                  "setJavaScriptEnabled": {
-                    "type": "boolean"
-                  },
-                  "url": {
-                    "type": "string"
-                  },
-                  "userAgent": {
-                    "type": "string"
-                  },
-                  "viewport": {
-                    "anyOf": [
-                      {
-                        "$ref": "#/definitions/Viewport"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "waitForEvent": {
-                    "type": "object",
-                    "properties": {
-                      "event": {
-                        "type": "string"
-                      },
-                      "timeout": {
-                        "type": "number"
-                      }
-                    },
-                    "additionalProperties": false,
-                    "required": [
-                      "event"
-                    ]
-                  },
-                  "waitForFunction": {
-                    "type": "object",
-                    "properties": {
-                      "fn": {
-                        "description": "The function, or statement, to be evaluated in browser context",
-                        "type": "string"
-                      },
-                      "polling": {
-                        "description": "An interval at which the pageFunction is executed, defaults to raf.\nIf polling is a number, then it is treated as an interval in milliseconds\nat which the function would be executed. If polling is a string,\nthen it can be one of the following values: \"raf\" or \"mutation\"",
-                        "type": [
-                          "string",
-                          "number"
-                        ]
-                      },
-                      "timeout": {
-                        "description": "Maximum time to wait for in milliseconds. Defaults to 30000 (30 seconds).\nPass 0 to disable timeout.",
-                        "type": "number"
-                      }
-                    },
-                    "additionalProperties": false,
-                    "required": [
-                      "fn"
-                    ]
-                  },
-                  "waitForSelector": {
-                    "type": "object",
-                    "properties": {
-                      "hidden": {
-                        "type": "boolean"
-                      },
-                      "selector": {
-                        "type": "string"
-                      },
-                      "timeout": {
-                        "type": "number"
-                      },
-                      "visible": {
-                        "type": "boolean"
-                      }
-                    },
-                    "additionalProperties": false,
-                    "required": [
-                      "selector"
-                    ]
-                  },
-                  "waitForTimeout": {
-                    "type": "number"
-                  }
-                },
-                "type": "object"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "description": "The JSON response body",
+                  "description": "The JSON response body",
                   "type": "object",
                   "properties": {
                     "data": {
@@ -5221,16 +4833,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/scrape /chromium/scrape",
+        "summary": "/chromium/scrape",
         "tags": [
           "Browser REST APIs"
         ]
       }
     },
-    "/screenshot /chromium/screenshot": {
+    "/chromium/screenshot": {
       "post": {
         "definitions": {},
-        "description": "A JSON-based API for getting a screenshot binary from either a supplied\n\"url\" or \"html\" payload in your request. Many options exist including\ncookies, user-agents, setting timers and network mocks.",
+        "description": "A JSON-based API for getting a screenshot binary from either a supplied\n\"url\" or \"html\" payload in your request. Many options exist including\ncookies, user-agents, setting timers and network mocks.\n\n**Note:** This endpoint is also available at: `/screenshot` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -5531,210 +5143,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/screenshot /chromium/screenshot",
+        "summary": "/chromium/screenshot",
         "tags": [
           "Browser REST APIs"
         ]
       }
     },
-    " /chromium": {
-      "get": {
+    "/edge/content": {
+      "post": {
         "definitions": {},
-        "description": "Launch and connect to Chromium with a library like puppeteer or others that work over chrome-devtools-protocol.",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "blockAds",
-            "schema": {
-              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
-              "type": "boolean"
-            }
-          },
-          {
-            "in": "query",
-            "name": "launch",
-            "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/CDPLaunchOptions"
-                },
-                {
-                  "type": "string"
-                }
-              ]
-            }
-          },
-          {
-            "in": "query",
-            "name": "timeout",
-            "schema": {
-              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
-              "type": "number"
-            }
-          },
-          {
-            "in": "query",
-            "name": "token",
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
-          {
-            "in": "query",
-            "name": "trackingId",
-            "schema": {
-              "description": "Custom session identifier",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {}
-        },
-        "responses": {
-          "101": {
-            "description": "Indicates successful WebSocket upgrade."
-          },
-          "400": {
-            "code": 400,
-            "description": "The request contains errors or didn't properly encode content.",
-            "message": "HTTP/1.1 400 Bad Request"
-          },
-          "401": {
-            "code": 401,
-            "description": "The request is missing, or contains bad, authorization credentials.",
-            "message": "HTTP/1.1 401 Unauthorized"
-          },
-          "404": {
-            "code": 404,
-            "description": "Resource couldn't be found.",
-            "message": "HTTP/1.1 404 Not Found"
-          },
-          "408": {
-            "code": 408,
-            "description": "The request took has taken too long to process.",
-            "message": "HTTP/1.1 408 Request Timeout"
-          },
-          "429": {
-            "code": 429,
-            "description": "Too many requests are currently being processed.",
-            "message": "HTTP/1.1 429 Too Many Requests"
-          },
-          "500": {
-            "code": 500,
-            "description": "An internal error occurred when handling the request.",
-            "message": "HTTP/1.1 500 Internal Server Error"
-          }
-        },
-        "summary": " /chromium",
-        "tags": [
-          "Browser WebSocket APIs"
-        ]
-      }
-    },
-    "/playwright/chromium /chromium/playwright": {
-      "get": {
-        "definitions": {},
-        "description": "Connect to Chromium with any playwright style library.",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "blockAds",
-            "schema": {
-              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
-              "type": "boolean"
-            }
-          },
-          {
-            "in": "query",
-            "name": "launch",
-            "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/BrowserServerOptions"
-                },
-                {
-                  "type": "string"
-                }
-              ]
-            }
-          },
-          {
-            "in": "query",
-            "name": "timeout",
-            "schema": {
-              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
-              "type": "number"
-            }
-          },
-          {
-            "in": "query",
-            "name": "token",
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
-          {
-            "in": "query",
-            "name": "trackingId",
-            "schema": {
-              "description": "Custom session identifier",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {}
-        },
-        "responses": {
-          "101": {
-            "description": "Indicates successful WebSocket upgrade."
-          },
-          "400": {
-            "code": 400,
-            "description": "The request contains errors or didn't properly encode content.",
-            "message": "HTTP/1.1 400 Bad Request"
-          },
-          "401": {
-            "code": 401,
-            "description": "The request is missing, or contains bad, authorization credentials.",
-            "message": "HTTP/1.1 401 Unauthorized"
-          },
-          "404": {
-            "code": 404,
-            "description": "Resource couldn't be found.",
-            "message": "HTTP/1.1 404 Not Found"
-          },
-          "408": {
-            "code": 408,
-            "description": "The request took has taken too long to process.",
-            "message": "HTTP/1.1 408 Request Timeout"
-          },
-          "429": {
-            "code": 429,
-            "description": "Too many requests are currently being processed.",
-            "message": "HTTP/1.1 429 Too Many Requests"
-          },
-          "500": {
-            "code": 500,
-            "description": "An internal error occurred when handling the request.",
-            "message": "HTTP/1.1 500 Internal Server Error"
-          }
-        },
-        "summary": "/playwright/chromium /chromium/playwright",
-        "tags": [
-          "Browser WebSocket APIs"
-        ]
-      }
-    },
-    "/edge/content": {
-      "post": {
-        "definitions": {},
-        "description": "A JSON-based API. Given a \"url\" or \"html\" field, runs and returns HTML content after the page has loaded and JavaScript has parsed.",
+        "description": "A JSON-based API. Given a \"url\" or \"html\" field, runs and returns HTML content after the page has loaded and JavaScript has parsed.",
         "parameters": [
           {
             "in": "query",
@@ -7624,66 +7042,15 @@
         ]
       }
     },
-    "/edge": {
+    "/active": {
       "get": {
         "definitions": {},
-        "description": "Launch and connect to Chromium with a library like puppeteer or others that work over chrome-devtools-protocol.",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "blockAds",
-            "schema": {
-              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
-              "type": "boolean"
-            }
-          },
-          {
-            "in": "query",
-            "name": "launch",
-            "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/CDPLaunchOptions"
-                },
-                {
-                  "type": "string"
-                }
-              ]
-            }
-          },
-          {
-            "in": "query",
-            "name": "timeout",
-            "schema": {
-              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
-              "type": "number"
-            }
-          },
-          {
-            "in": "query",
-            "name": "token",
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
-          {
-            "in": "query",
-            "name": "trackingId",
-            "schema": {
-              "description": "Custom session identifier",
-              "type": "string"
-            }
-          }
-        ],
+        "description": "Returns a simple \"204\" HTTP code, with no response, indicating that the service itself is up and running.\nUseful for liveliness probes or other external checks.",
+        "parameters": [],
         "requestBody": {
           "content": {}
         },
         "responses": {
-          "101": {
-            "description": "Indicates successful WebSocket upgrade."
-          },
           "400": {
             "code": 400,
             "description": "The request contains errors or didn't properly encode content.",
@@ -7715,317 +7082,13 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/edge",
+        "summary": "/active",
         "tags": [
-          "Browser WebSocket APIs"
+          "Management REST APIs"
         ]
       }
     },
-    "/edge/playwright": {
-      "get": {
-        "definitions": {},
-        "description": "Connect to Chromium with any playwright style library.",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "blockAds",
-            "schema": {
-              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
-              "type": "boolean"
-            }
-          },
-          {
-            "in": "query",
-            "name": "launch",
-            "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/BrowserServerOptions"
-                },
-                {
-                  "type": "string"
-                }
-              ]
-            }
-          },
-          {
-            "in": "query",
-            "name": "timeout",
-            "schema": {
-              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
-              "type": "number"
-            }
-          },
-          {
-            "in": "query",
-            "name": "token",
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
-          {
-            "in": "query",
-            "name": "trackingId",
-            "schema": {
-              "description": "Custom session identifier",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {}
-        },
-        "responses": {
-          "101": {
-            "description": "Indicates successful WebSocket upgrade."
-          },
-          "400": {
-            "code": 400,
-            "description": "The request contains errors or didn't properly encode content.",
-            "message": "HTTP/1.1 400 Bad Request"
-          },
-          "401": {
-            "code": 401,
-            "description": "The request is missing, or contains bad, authorization credentials.",
-            "message": "HTTP/1.1 401 Unauthorized"
-          },
-          "404": {
-            "code": 404,
-            "description": "Resource couldn't be found.",
-            "message": "HTTP/1.1 404 Not Found"
-          },
-          "408": {
-            "code": 408,
-            "description": "The request took has taken too long to process.",
-            "message": "HTTP/1.1 408 Request Timeout"
-          },
-          "429": {
-            "code": 429,
-            "description": "Too many requests are currently being processed.",
-            "message": "HTTP/1.1 429 Too Many Requests"
-          },
-          "500": {
-            "code": 500,
-            "description": "An internal error occurred when handling the request.",
-            "message": "HTTP/1.1 500 Internal Server Error"
-          }
-        },
-        "summary": "/edge/playwright",
-        "tags": [
-          "Browser WebSocket APIs"
-        ]
-      }
-    },
-    "/playwright/firefox /firefox/playwright": {
-      "get": {
-        "definitions": {},
-        "description": "Connect to Firefox with any playwright-compliant library.",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "blockAds",
-            "schema": {
-              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
-              "type": "boolean"
-            }
-          },
-          {
-            "in": "query",
-            "name": "launch",
-            "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
-              "additionalProperties": false,
-              "type": "object",
-              "properties": {
-                "args": {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  }
-                },
-                "chromiumSandbox": {
-                  "type": "boolean"
-                },
-                "devtools": {
-                  "type": "boolean"
-                },
-                "downloadsPath": {
-                  "type": "string"
-                },
-                "headless": {
-                  "type": "boolean"
-                },
-                "ignoreDefaultArgs": {
-                  "anyOf": [
-                    {
-                      "type": "array",
-                      "items": {
-                        "type": "string"
-                      }
-                    },
-                    {
-                      "type": "boolean"
-                    }
-                  ]
-                },
-                "proxy": {
-                  "type": "object",
-                  "properties": {
-                    "bypass": {
-                      "type": "string"
-                    },
-                    "password": {
-                      "type": "string"
-                    },
-                    "server": {
-                      "type": "string"
-                    },
-                    "username": {
-                      "type": "string"
-                    }
-                  },
-                  "additionalProperties": false,
-                  "required": [
-                    "server"
-                  ]
-                },
-                "timeout": {
-                  "type": "number"
-                },
-                "tracesDir": {
-                  "type": "string"
-                },
-                "firefoxUserPrefs": {
-                  "type": "object",
-                  "additionalProperties": {
-                    "type": [
-                      "string",
-                      "number",
-                      "boolean"
-                    ]
-                  }
-                }
-              }
-            }
-          },
-          {
-            "in": "query",
-            "name": "timeout",
-            "schema": {
-              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
-              "type": "number"
-            }
-          },
-          {
-            "in": "query",
-            "name": "token",
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
-          {
-            "in": "query",
-            "name": "trackingId",
-            "schema": {
-              "description": "Custom session identifier",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {}
-        },
-        "responses": {
-          "101": {
-            "description": "Indicates successful WebSocket upgrade."
-          },
-          "400": {
-            "code": 400,
-            "description": "The request contains errors or didn't properly encode content.",
-            "message": "HTTP/1.1 400 Bad Request"
-          },
-          "401": {
-            "code": 401,
-            "description": "The request is missing, or contains bad, authorization credentials.",
-            "message": "HTTP/1.1 401 Unauthorized"
-          },
-          "404": {
-            "code": 404,
-            "description": "Resource couldn't be found.",
-            "message": "HTTP/1.1 404 Not Found"
-          },
-          "408": {
-            "code": 408,
-            "description": "The request took has taken too long to process.",
-            "message": "HTTP/1.1 408 Request Timeout"
-          },
-          "429": {
-            "code": 429,
-            "description": "Too many requests are currently being processed.",
-            "message": "HTTP/1.1 429 Too Many Requests"
-          },
-          "500": {
-            "code": 500,
-            "description": "An internal error occurred when handling the request.",
-            "message": "HTTP/1.1 500 Internal Server Error"
-          }
-        },
-        "summary": "/playwright/firefox /firefox/playwright",
-        "tags": [
-          "Browser WebSocket APIs"
-        ]
-      }
-    },
-    "/active": {
-      "get": {
-        "definitions": {},
-        "description": "Returns a simple \"204\" HTTP code, with no response, indicating that the service itself is up and running.\nUseful for liveliness probes or other external checks.",
-        "parameters": [],
-        "requestBody": {
-          "content": {}
-        },
-        "responses": {
-          "400": {
-            "code": 400,
-            "description": "The request contains errors or didn't properly encode content.",
-            "message": "HTTP/1.1 400 Bad Request"
-          },
-          "401": {
-            "code": 401,
-            "description": "The request is missing, or contains bad, authorization credentials.",
-            "message": "HTTP/1.1 401 Unauthorized"
-          },
-          "404": {
-            "code": 404,
-            "description": "Resource couldn't be found.",
-            "message": "HTTP/1.1 404 Not Found"
-          },
-          "408": {
-            "code": 408,
-            "description": "The request took has taken too long to process.",
-            "message": "HTTP/1.1 408 Request Timeout"
-          },
-          "429": {
-            "code": 429,
-            "description": "Too many requests are currently being processed.",
-            "message": "HTTP/1.1 429 Too Many Requests"
-          },
-          "500": {
-            "code": 500,
-            "description": "An internal error occurred when handling the request.",
-            "message": "HTTP/1.1 500 Internal Server Error"
-          }
-        },
-        "summary": "/active",
-        "tags": [
-          "Management REST APIs"
-        ]
-      }
-    },
-    "/config": {
+    "/config": {
       "get": {
         "definitions": {},
         "description": "Returns a JSON payload of the current system configuration.",
@@ -8434,27 +7497,803 @@
             "description": "Too many requests are currently being processed.",
             "message": "HTTP/1.1 429 Too Many Requests"
           },
-          "500": {
-            "code": 500,
-            "description": "An internal error occurred when handling the request.",
-            "message": "HTTP/1.1 500 Internal Server Error"
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/metrics/total",
+        "tags": [
+          "Management REST APIs"
+        ]
+      }
+    },
+    "/metrics": {
+      "get": {
+        "definitions": {},
+        "description": "Returns a list of metric details as far back as possible.",
+        "parameters": [],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/metrics",
+        "tags": [
+          "Management REST APIs"
+        ]
+      }
+    },
+    "/pressure": {
+      "get": {
+        "definitions": {},
+        "description": "Returns a JSON body of stats related to the pressure being created on the instance.",
+        "parameters": [],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/pressure",
+        "tags": [
+          "Management REST APIs"
+        ]
+      }
+    },
+    "/sessions": {
+      "get": {
+        "definitions": {},
+        "description": "Lists all currently running sessions and relevant meta-data excluding potentially open pages.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "token",
+            "required": true,
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "blockAds",
+            "required": false,
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "required": false,
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
+                {
+                  "$ref": "#/definitions/BrowserServerOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "required": false,
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "trackingId",
+            "required": false,
+            "schema": {
+              "description": "Custom session identifier",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/sessions",
+        "tags": [
+          "Management REST APIs"
+        ]
+      }
+    },
+    "/": {
+      "get": {
+        "definitions": {},
+        "description": "Serves static files inside of this \"static\" directory. Content-types will vary depending on the type =of file being returned.",
+        "parameters": [],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/",
+        "tags": [
+          "Management REST APIs"
+        ]
+      }
+    },
+    "/devtools/browser/*": {
+      "get": {
+        "definitions": {},
+        "description": "Connect to an already-running Chromium process with a library like\npuppeteer, or others, that work over chrome-devtools-protocol. Chromium\nmust already be launched in order to not return a 404.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "trackingId",
+            "schema": {
+              "description": "Custom session identifier",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
+          },
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/devtools/browser/*",
+        "tags": [
+          "Browser WebSocket APIs"
+        ]
+      }
+    },
+    "/chrome": {
+      "get": {
+        "definitions": {},
+        "description": "Launch and connect to Chromium with a library like puppeteer or others that work over chrome-devtools-protocol.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "trackingId",
+            "schema": {
+              "description": "Custom session identifier",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
+          },
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/chrome",
+        "tags": [
+          "Browser WebSocket APIs"
+        ]
+      }
+    },
+    "/devtools/page/*": {
+      "get": {
+        "definitions": {},
+        "description": "Connect to an existing page in Chromium with a library like\nchrome-remote-interface or others that work the page websocketDebugger\nURL. You can get this unique URL by calling the /json/list API\nor by finding the page's unique ID from your library of choice.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "trackingId",
+            "schema": {
+              "description": "Custom session identifier",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
+          },
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/devtools/page/*",
+        "tags": [
+          "Browser WebSocket APIs"
+        ]
+      }
+    },
+    "/chrome/playwright": {
+      "get": {
+        "definitions": {},
+        "description": "Connect to Chromium with any playwright style library.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/BrowserServerOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "trackingId",
+            "schema": {
+              "description": "Custom session identifier",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
+          },
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/chrome/playwright",
+        "tags": [
+          "Browser WebSocket APIs"
+        ]
+      }
+    },
+    "/chromium": {
+      "get": {
+        "definitions": {},
+        "description": "Launch and connect to Chromium with a library like puppeteer or others that work over chrome-devtools-protocol.\n\n**Note:** This endpoint is also available at: `` for backwards compatibility.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "trackingId",
+            "schema": {
+              "description": "Custom session identifier",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
+          },
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/chromium",
+        "tags": [
+          "Browser WebSocket APIs"
+        ]
+      }
+    },
+    "/playwright/chromium": {
+      "get": {
+        "definitions": {},
+        "description": "Connect to Chromium with any playwright style library.\n\n**Note:** This endpoint is also available at: `/chromium/playwright` for backwards compatibility.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/BrowserServerOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "trackingId",
+            "schema": {
+              "description": "Custom session identifier",
+              "type": "string"
+            }
           }
-        },
-        "summary": "/metrics/total",
-        "tags": [
-          "Management REST APIs"
-        ]
-      }
-    },
-    "/metrics": {
-      "get": {
-        "definitions": {},
-        "description": "Returns a list of metric details as far back as possible.",
-        "parameters": [],
+        ],
         "requestBody": {
           "content": {}
         },
         "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
+          },
           "400": {
             "code": 400,
             "description": "The request contains errors or didn't properly encode content.",
@@ -8486,21 +8325,72 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/metrics",
+        "summary": "/playwright/chromium",
         "tags": [
-          "Management REST APIs"
+          "Browser WebSocket APIs"
         ]
       }
     },
-    "/pressure": {
+    "/edge": {
       "get": {
         "definitions": {},
-        "description": "Returns a JSON body of stats related to the pressure being created on the instance.",
-        "parameters": [],
+        "description": "Launch and connect to Chromium with a library like puppeteer or others that work over chrome-devtools-protocol.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "trackingId",
+            "schema": {
+              "description": "Custom session identifier",
+              "type": "string"
+            }
+          }
+        ],
         "requestBody": {
           "content": {}
         },
         "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
+          },
           "400": {
             "code": 400,
             "description": "The request contains errors or didn't properly encode content.",
@@ -8532,30 +8422,20 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/pressure",
+        "summary": "/edge",
         "tags": [
-          "Management REST APIs"
+          "Browser WebSocket APIs"
         ]
       }
     },
-    "/sessions": {
+    "/edge/playwright": {
       "get": {
         "definitions": {},
-        "description": "Lists all currently running sessions and relevant meta-data excluding potentially open pages.",
+        "description": "Connect to Chromium with any playwright style library.",
         "parameters": [
-          {
-            "in": "query",
-            "name": "token",
-            "required": true,
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
           {
             "in": "query",
             "name": "blockAds",
-            "required": false,
             "schema": {
               "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
               "type": "boolean"
@@ -8564,13 +8444,9 @@
           {
             "in": "query",
             "name": "launch",
-            "required": false,
             "schema": {
               "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
               "anyOf": [
-                {
-                  "$ref": "#/definitions/CDPLaunchOptions"
-                },
                 {
                   "$ref": "#/definitions/BrowserServerOptions"
                 },
@@ -8583,16 +8459,22 @@
           {
             "in": "query",
             "name": "timeout",
-            "required": false,
             "schema": {
               "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
               "type": "number"
             }
           },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
           {
             "in": "query",
             "name": "trackingId",
-            "required": false,
             "schema": {
               "description": "Custom session identifier",
               "type": "string"
@@ -8603,6 +8485,9 @@
           "content": {}
         },
         "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
+          },
           "400": {
             "code": 400,
             "description": "The request contains errors or didn't properly encode content.",
@@ -8634,21 +8519,136 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/sessions",
+        "summary": "/edge/playwright",
         "tags": [
-          "Management REST APIs"
+          "Browser WebSocket APIs"
         ]
       }
     },
-    "/": {
+    "/playwright/firefox": {
       "get": {
         "definitions": {},
-        "description": "Serves static files inside of this \"static\" directory. Content-types will vary depending on the type =of file being returned.",
-        "parameters": [],
+        "description": "Connect to Firefox with any playwright-compliant library.\n\n**Note:** This endpoint is also available at: `/firefox/playwright` for backwards compatibility.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "additionalProperties": false,
+              "type": "object",
+              "properties": {
+                "args": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "chromiumSandbox": {
+                  "type": "boolean"
+                },
+                "devtools": {
+                  "type": "boolean"
+                },
+                "downloadsPath": {
+                  "type": "string"
+                },
+                "headless": {
+                  "type": "boolean"
+                },
+                "ignoreDefaultArgs": {
+                  "anyOf": [
+                    {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    {
+                      "type": "boolean"
+                    }
+                  ]
+                },
+                "proxy": {
+                  "type": "object",
+                  "properties": {
+                    "bypass": {
+                      "type": "string"
+                    },
+                    "password": {
+                      "type": "string"
+                    },
+                    "server": {
+                      "type": "string"
+                    },
+                    "username": {
+                      "type": "string"
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "server"
+                  ]
+                },
+                "timeout": {
+                  "type": "number"
+                },
+                "tracesDir": {
+                  "type": "string"
+                },
+                "firefoxUserPrefs": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": [
+                      "string",
+                      "number",
+                      "boolean"
+                    ]
+                  }
+                }
+              }
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "trackingId",
+            "schema": {
+              "description": "Custom session identifier",
+              "type": "string"
+            }
+          }
+        ],
         "requestBody": {
           "content": {}
         },
         "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
+          },
           "400": {
             "code": 400,
             "description": "The request contains errors or didn't properly encode content.",
@@ -8680,16 +8680,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/",
+        "summary": "/playwright/firefox",
         "tags": [
-          "Management REST APIs"
+          "Browser WebSocket APIs"
         ]
       }
     },
-    "/playwright/webkit /webkit/playwright": {
+    "/playwright/webkit": {
       "get": {
         "definitions": {},
-        "description": "Connect to Webkit with any playwright-compliant library.",
+        "description": "Connect to Webkit with any playwright-compliant library.\n\n**Note:** This endpoint is also available at: `/webkit/playwright` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -8777,7 +8777,7 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/playwright/webkit /webkit/playwright",
+        "summary": "/playwright/webkit",
         "tags": [
           "Browser WebSocket APIs"
         ]