{
"error": {
"code": "upstream_error",
"message": "Failed to fetch data from an upstream service.",
"details": {
"upstreamStatus": 503
}
}
}
Cloud Browser
Create a Session
Creates and starts a browser. The smallest request is . Add startUrl to open one or more pages at launch, or navigate with Playwright or Puppeteer after connecting. Supply startUrl as one string of absolute HTTP or HTTPS URLs separated by commas without spaces, up to 2,048 characters total. Omit startUrl when supplying settings.id. Use the returned WebSocket URL to connect, select the tab by URL, and wait for the page content you need.
{
"error": {
"code": "upstream_error",
"message": "Failed to fetch data from an upstream service.",
"details": {
"upstreamStatus": 503
}
}
}
The smallest request is {}. Add optional startUrl to open one or more pages at launch: supply absolute HTTP or HTTPS URLs in one string, separated by commas without spaces, up to 2,048 characters total. Omit startUrl when supplying settings.id.
For example, this request body opens two separate tabs:
Connect with the returned connectUrl to work with the opened tabs. Select the tab by URL and wait for the page content you need. If you omit startUrl, navigate with Playwright or Puppeteer after connecting.
Follow the Cloud Browser guide
Create, connect, navigate, reuse settings, and stop a browser safely.
Session-first browser request. Every field is optional. Use startUrl to open pages at launch, or navigate after connecting. Do not combine startUrl with settings.id.
Optional start URL or comma-separated list of start URLs. Each URL opens in a separate tab when the browser launches. Use absolute HTTP or HTTPS URLs, separated by commas without spaces. Supply one string, not a JSON array. The 2,048-character limit applies to the complete string, including separators. Percent-encode commas inside a URL as %2C. Omit this field when supplying settings.id. Wait for the page content you need after connecting.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Floppydata Client API","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/floppydata/t-In33JhdHge9jll/logo/light.svg?fit=max\u0026auto=format\u0026n=t-In33JhdHge9jll\u0026q=85\u0026s=2b3535dc315190c13602ee83ea3378c2","dark":"https://mintcdn.com/floppydata/t-In33JhdHge9jll/logo/dark.svg?fit=max\u0026auto=format\u0026n=t-In33JhdHge9jll\u0026q=85\u0026s=0f73f0b83947c39a68c2b0167841ab91"},"favicon":"https://mintcdn.com/floppydata/7MGx7VQNZ_E0n9Af/favicon.svg?fit=max\u0026auto=format\u0026n=7MGx7VQNZ_E0n9Af\u0026q=85\u0026s=eb959f0fd197b23eaa20c112427e3ede","api":{"openapi":["api-reference/openapi.json","api-reference/openapi-v1.json"],"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript"],"prefill":true},"url":"full"},"navbar":{"links":[{"href":"https://app.floppydata.com","label":"Dashboard"}],"primary":{"type":"button","label":"Get API key","href":"https://app.floppydata.com/api-keys"}},"footer":{"socials":{"github":"https://github.com/Floppydata/floppydata-docs"}},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"floppydata","hasAudioNarration":false,"actualSubdomain":"floppydata","customDomains":["floppydata.com"],"gitSource":{"type":"github","owner":"floppydata","repo":"floppydata-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":false,"edits":false},"entitlements":{},"buildId":"6acf3140c1c56b6740ebd9ed","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API Reference","count":22},{"language":"default","tag":"V2","count":22},{"language":"default","tag":"Proxy","count":9},{"language":"default","tag":"Guides","count":9},{"language":"default","tag":"Cloud Browser","count":7},{"language":"default","tag":"Rotating","count":7},{"language":"default","tag":"Start","count":6},{"language":"default","tag":"Core API tasks","count":6},{"language":"default","tag":"Web Data","count":4},{"language":"default","tag":"Proxy setup","count":3}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/v2/endpoint/browser-session-create","slug":"/api-reference/v2/endpoint/browser-session-create","pageMetadata":{"title":"Create a Session","openapi":"api-reference/openapi.json POST /v2/browser/sessions","description":"Creates and starts a browser. The smallest request is {}. Add startUrl to open one or more pages at launch, or navigate with Playwright or Puppeteer after connecting. Supply startUrl as one string of absolute HTTP or HTTPS URLs separated by commas without spaces, up to 2,048 characters total. Omit startUrl when supplying settings.id. Use the returned WebSocket URL to connect, select the tab by URL, and wait for the page content you need.","href":"/api-reference/v2/endpoint/browser-session-create"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Creates and starts a browser. The smallest request is \", \". Add startUrl to open one or more pages at launch, or navigate with Playwright or Puppeteer after connecting. Supply startUrl as one string of absolute HTTP or HTTPS URLs separated by commas without spaces, up to 2,048 characters total. Omit startUrl when supplying settings.id. Use the returned WebSocket URL to connect, select the tab by URL, and wait for the page content you need.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{Card,CodeBlock,Note}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:_jsxs(_components.p,{children:[`The smallest request is `,_jsx(_components.code,{children:`{}`}),`. Add optional `,_jsx(_components.code,{children:`startUrl`}),` to open one or more pages at launch: supply absolute HTTP or HTTPS URLs in one string, separated by commas without spaces, up to 2,048 characters total. Omit `,_jsx(_components.code,{children:`startUrl`}),` when supplying `,_jsx(_components.code,{children:`settings.id`}),`.`]})}),`\n`,_jsx(_components.p,{children:`For example, this request body opens two separate tabs:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"startUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/,https://example.org/\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Connect with the returned `,_jsx(_components.code,{children:`connectUrl`}),` to work with the opened tabs. Select the tab by URL and wait for the page content you need. If you omit `,_jsx(_components.code,{children:`startUrl`}),`, navigate with Playwright or Puppeteer after connecting.`]}),`\n`,_jsx(Card,{title:`Follow the Cloud Browser guide`,icon:`browser`,href:`/guides/cloud-browser`,children:_jsx(_components.p,{children:`Create, connect, navigate, reuse settings, and stop a browser safely.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a Session","openapi":"api-reference/openapi.json POST /v2/browser/sessions","description":"Creates and starts a browser. The smallest request is {}. Add startUrl to open one or more pages at launch, or navigate with Playwright or Puppeteer after connecting. Supply startUrl as one string of absolute HTTP or HTTPS URLs separated by commas without spaces, up to 2,048 characters total. Omit startUrl when supplying settings.id. Use the returned WebSocket URL to connect, select the tab by URL, and wait for the page content you need.","href":"/api-reference/v2/endpoint/browser-session-create"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createBrowserSession","summary":"Create a browser session","description":"Creates and starts a browser. The smallest request is {}. Add startUrl to open one or more pages at launch, or navigate with Playwright or Puppeteer after connecting. Supply startUrl as one string of absolute HTTP or HTTPS URLs separated by commas without spaces, up to 2,048 characters total. Omit startUrl when supplying settings.id. Use the returned WebSocket URL to connect, select the tab by URL, and wait for the page content you need.","tags":["Cloud Browser"],"responses":{"201":"680a249f-b104-4f08-bec5-482899381dde","400":"c755ead8-f12c-4450-84b0-a2c6b6d48421","401":"62d7d4db-8bce-44b7-92c2-666b557dd31e","402":"6e0c9452-2c35-487f-8a02-cf5de6233071","403":"6963e156-93f2-48e3-bf43-5a35e87cc258","404":"c1f1d5c9-3a25-4059-8054-37117549160e","409":"2c076345-f7a3-4eaf-8118-cf41f4597ed8","500":"ad299892-5ab7-46bc-9310-e6f450985452","502":"a10586d9-4803-4be4-90ea-38f707d2f3fa"},"requestBody":"d95fa0b2-1ba7-4674-b7b0-531e1912ebc6","method":"post","type":"path","servers":["5a416e7f-7912-470a-86f6-f1cfb9117df7"],"security":["af1e0e9b-cfa3-42c1-ab39-d4abb4facf41"],"path":"/v2/browser/sessions","baseUrlOptions":["https://api.floppydata.net"],"title":"Create a browser session","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.startUrl":"https://example.com/"},{"body.startUrl":"https://example.com/,https://example.org/"},{}],"urlDisplay":"full"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"settings":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","isRequired":true,"uniqueKey":"settings.id","typeLabel":"string\u003cuuid>"}},"required":["id"],"additionalProperties":false,"uniqueKey":"settings","typeLabel":"object"},"browser":{"type":"object","properties":{"viewport":{"type":"object","properties":{"width":{"type":"integer","minimum":320,"maximum":7680,"isRequired":true,"uniqueKey":"browser.viewport.width","typeLabel":"integer"},"height":{"type":"integer","minimum":240,"maximum":4320,"isRequired":true,"uniqueKey":"browser.viewport.height","typeLabel":"integer"}},"required":["width","height"],"additionalProperties":false,"uniqueKey":"browser.viewport","typeLabel":"object"},"fingerprint":{"type":"object","properties":{"strategy":{"default":"auto","type":"string","enum":["auto","custom"],"uniqueKey":"browser.fingerprint.strategy","typeLabel":"enum\u003cstring>"},"os":{"type":"string","enum":["linux","windows","macos","android"],"uniqueKey":"browser.fingerprint.os","typeLabel":"enum\u003cstring>"},"osVersion":{"type":"string","minLength":1,"maxLength":64,"uniqueKey":"browser.fingerprint.osVersion","typeLabel":"string"},"userAgent":{"type":"string","minLength":1,"maxLength":1024,"uniqueKey":"browser.fingerprint.userAgent","typeLabel":"string"},"screen":{"type":"object","properties":{"width":{"type":"integer","minimum":320,"maximum":7680,"isRequired":true,"uniqueKey":"browser.fingerprint.screen.width","typeLabel":"integer"},"height":{"type":"integer","minimum":240,"maximum":4320,"isRequired":true,"uniqueKey":"browser.fingerprint.screen.height","typeLabel":"integer"},"devicePixelRatio":{"type":"number","minimum":0.5,"maximum":8,"uniqueKey":"browser.fingerprint.screen.devicePixelRatio","typeLabel":"number"}},"required":["width","height"],"additionalProperties":false,"uniqueKey":"browser.fingerprint.screen","typeLabel":"object"},"locale":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$","uniqueKey":"browser.fingerprint.locale","typeLabel":"string"},"timezone":{"oneOf":[{"type":"string","const":"auto","uniqueKey":"browser.fingerprint.timezone.oneOf.0","typeLabel":"string"},{"type":"string","maxLength":64,"pattern":"^[A-Za-z_+-]+(?:\\/[A-Za-z0-9_+.-]+)+$","uniqueKey":"browser.fingerprint.timezone.oneOf.1","typeLabel":"string"}],"uniqueKey":"browser.fingerprint.timezone","typeLabel":"string"},"geolocation":{"type":"object","properties":{"mode":{"type":"string","enum":["auto","custom","disabled"],"isRequired":true,"uniqueKey":"browser.fingerprint.geolocation.mode","typeLabel":"enum\u003cstring>"},"latitude":{"type":"number","minimum":-90,"maximum":90,"uniqueKey":"browser.fingerprint.geolocation.latitude","typeLabel":"number"},"longitude":{"type":"number","minimum":-180,"maximum":180,"uniqueKey":"browser.fingerprint.geolocation.longitude","typeLabel":"number"},"accuracy":{"type":"number","exclusiveMinimum":0,"maximum":100000,"uniqueKey":"browser.fingerprint.geolocation.accuracy","typeLabel":"number"}},"required":["mode"],"additionalProperties":false,"uniqueKey":"browser.fingerprint.geolocation","typeLabel":"object"},"hardware":{"type":"object","properties":{"cpuCores":{"type":"integer","minimum":1,"maximum":128,"uniqueKey":"browser.fingerprint.hardware.cpuCores","typeLabel":"integer"},"memoryGb":{"type":"integer","minimum":1,"maximum":256,"uniqueKey":"browser.fingerprint.hardware.memoryGb","typeLabel":"integer"},"maxTouchPoints":{"type":"integer","minimum":0,"maximum":20,"uniqueKey":"browser.fingerprint.hardware.maxTouchPoints","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"browser.fingerprint.hardware","typeLabel":"object"},"masking":{"type":"object","properties":{"canvas":{"type":"string","enum":["auto","noise","off"],"uniqueKey":"browser.fingerprint.masking.canvas","typeLabel":"enum\u003cstring>"},"webgl":{"type":"object","properties":{"mode":{"type":"string","enum":["auto","noise","mask","off"],"uniqueKey":"browser.fingerprint.masking.webgl.mode","typeLabel":"enum\u003cstring>"},"vendor":{"type":"string","minLength":1,"maxLength":256,"uniqueKey":"browser.fingerprint.masking.webgl.vendor","typeLabel":"string"},"renderer":{"type":"string","minLength":1,"maxLength":512,"uniqueKey":"browser.fingerprint.masking.webgl.renderer","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"browser.fingerprint.masking.webgl","typeLabel":"object"},"audioContext":{"type":"string","enum":["auto","noise","off"],"uniqueKey":"browser.fingerprint.masking.audioContext","typeLabel":"enum\u003cstring>"},"clientRects":{"type":"string","enum":["auto","noise","off"],"uniqueKey":"browser.fingerprint.masking.clientRects","typeLabel":"enum\u003cstring>"},"webrtc":{"type":"string","enum":["auto","proxy","disabled"],"uniqueKey":"browser.fingerprint.masking.webrtc","typeLabel":"enum\u003cstring>"},"mediaDevices":{"type":"object","properties":{"mode":{"type":"string","enum":["auto","mask","disabled"],"uniqueKey":"browser.fingerprint.masking.mediaDevices.mode","typeLabel":"enum\u003cstring>"},"videoInputs":{"type":"integer","minimum":0,"maximum":20,"uniqueKey":"browser.fingerprint.masking.mediaDevices.videoInputs","typeLabel":"integer"},"audioInputs":{"type":"integer","minimum":0,"maximum":20,"uniqueKey":"browser.fingerprint.masking.mediaDevices.audioInputs","typeLabel":"integer"},"audioOutputs":{"type":"integer","minimum":0,"maximum":20,"uniqueKey":"browser.fingerprint.masking.mediaDevices.audioOutputs","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"browser.fingerprint.masking.mediaDevices","typeLabel":"object"},"fonts":{"type":"object","properties":{"mode":{"type":"string","enum":["auto","custom"],"uniqueKey":"browser.fingerprint.masking.fonts.mode","typeLabel":"enum\u003cstring>"},"families":{"maxItems":256,"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"browser.fingerprint.masking.fonts.families.items.[INDEX]","typeLabel":"string"},"uniqueKey":"browser.fingerprint.masking.fonts.families","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"browser.fingerprint.masking.fonts","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"browser.fingerprint.masking","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"browser.fingerprint","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"browser","typeLabel":"object"},"storage":{"type":"object","properties":{"cookies":{"type":"object","properties":{"items":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":256,"isRequired":true,"uniqueKey":"storage.cookies.\\items.items.[INDEX].name","typeLabel":"string"},"value":{"type":"string","maxLength":16384,"isRequired":true,"uniqueKey":"storage.cookies.\\items.items.[INDEX].value","typeLabel":"string"},"url":{"type":"string","maxLength":2048,"format":"uri","uniqueKey":"storage.cookies.\\items.items.[INDEX].url","typeLabel":"string\u003curi>"},"domain":{"type":"string","minLength":1,"maxLength":253,"uniqueKey":"storage.cookies.\\items.items.[INDEX].domain","typeLabel":"string"},"path":{"type":"string","minLength":1,"maxLength":2048,"uniqueKey":"storage.cookies.\\items.items.[INDEX].path","typeLabel":"string"},"expires":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"storage.cookies.\\items.items.[INDEX].expires","typeLabel":"integer"},"httpOnly":{"type":"boolean","uniqueKey":"storage.cookies.\\items.items.[INDEX].httpOnly","typeLabel":"boolean"},"secure":{"type":"boolean","uniqueKey":"storage.cookies.\\items.items.[INDEX].secure","typeLabel":"boolean"},"sameSite":{"type":"string","enum":["strict","lax","none"],"uniqueKey":"storage.cookies.\\items.items.[INDEX].sameSite","typeLabel":"enum\u003cstring>"}},"required":["name","value"],"additionalProperties":false,"uniqueKey":"storage.cookies.\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"storage.cookies.\\items","typeLabel":"object[]"},"mode":{"default":"merge","type":"string","enum":["merge","replace"],"uniqueKey":"storage.cookies.mode","typeLabel":"enum\u003cstring>"}},"required":["items"],"additionalProperties":false,"uniqueKey":"storage.cookies","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"storage","typeLabel":"object"},"proxy":{"type":"object","properties":{"type":{"default":"residential","type":"string","enum":["residential","mobile","datacenter"],"uniqueKey":"proxy.type","typeLabel":"enum\u003cstring>"},"location":{"type":"object","properties":{"countryCode":{"type":"string","minLength":2,"maxLength":2,"pattern":"^[A-Za-z]{2}$","uniqueKey":"proxy.location.countryCode","typeLabel":"string"},"state":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"proxy.location.state","typeLabel":"string"},"city":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"proxy.location.city","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"proxy.location","typeLabel":"object"},"asn":{"type":"string","maxLength":32,"pattern":"^\\d+$","uniqueKey":"proxy.asn","typeLabel":"string"},"rotation":{"type":"object","properties":{"mode":{"default":"sticky","type":"string","enum":["sticky","perRequest","interval"],"uniqueKey":"proxy.rotation.mode","typeLabel":"enum\u003cstring>"},"intervalMinutes":{"oneOf":[{"type":"number","const":5,"uniqueKey":"proxy.rotation.intervalMinutes.oneOf.0","typeLabel":"number"},{"type":"number","const":10,"uniqueKey":"proxy.rotation.intervalMinutes.oneOf.1","typeLabel":"number"},{"type":"number","const":15,"uniqueKey":"proxy.rotation.intervalMinutes.oneOf.2","typeLabel":"number"},{"type":"number","const":20,"uniqueKey":"proxy.rotation.intervalMinutes.oneOf.3","typeLabel":"number"},{"type":"number","const":60,"uniqueKey":"proxy.rotation.intervalMinutes.oneOf.4","typeLabel":"number"}],"uniqueKey":"proxy.rotation.intervalMinutes","typeLabel":"number"},"stickyKey":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"proxy.rotation.stickyKey","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"proxy.rotation","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"proxy","typeLabel":"object"},"runtime":{"default":{"timeoutSeconds":600,"keepAlive":false},"type":"object","properties":{"timeoutSeconds":{"default":600,"type":"integer","minimum":60,"maximum":21600,"uniqueKey":"runtime.timeoutSeconds","typeLabel":"integer"},"keepAlive":{"default":false,"type":"boolean","uniqueKey":"runtime.keepAlive","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"runtime","typeLabel":"object"},"startUrl":{"type":"string","maxLength":2048,"format":"uri","description":"Optional start URL or comma-separated list of start URLs. Each URL opens in a separate tab when the browser launches. Use absolute HTTP or HTTPS URLs, separated by commas without spaces. Supply one string, not a JSON array. The 2,048-character limit applies to the complete string, including separators. Percent-encode commas inside a URL as %2C. Omit this field when supplying settings.id. Wait for the page content you need after connecting.","example":"https://example.com/,https://example.org/","uniqueKey":"startUrl","typeLabel":"string\u003curi>"},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"metadata.additionalProperties","typeLabel":"any"},"uniqueKey":"metadata","typeLabel":"object"}},"additionalProperties":false,"description":"Session-first browser request. Every field is optional. Use startUrl to open pages at launch, or navigate after connecting. Do not combine startUrl with settings.id.","uniqueKey":"","typeLabel":"object"},"examples":{"oneStartUrl":{"title":"oneStartUrl","value":{"startUrl":"https://example.com/"}},"multipleStartUrls":{"title":"multipleStartUrls","value":{"startUrl":"https://example.com/,https://example.org/"}},"withoutStartUrl":{"title":"withoutStartUrl","value":{}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"680a249f-b104-4f08-bec5-482899381dde":{"description":"Browser session started.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["running","stopped","timedOut","failed"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"connectUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"connectUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"connectUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"connectUrl","typeLabel":"string | null"},"settings":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","isRequired":true,"uniqueKey":"settings.id","typeLabel":"string\u003cuuid>"}},"required":["id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"settings","typeLabel":"object"},"runtime":{"type":"object","properties":{"timeoutSeconds":{"default":600,"type":"integer","minimum":60,"maximum":21600,"uniqueKey":"runtime.timeoutSeconds","typeLabel":"integer"},"keepAlive":{"default":false,"type":"boolean","uniqueKey":"runtime.keepAlive","typeLabel":"boolean"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"runtime","typeLabel":"object"},"createdAt":{"type":"string","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string"},"startedAt":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"startedAt.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"startedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"startedAt","typeLabel":"string | null"},"expiresAt":{"type":"string","isRequired":true,"uniqueKey":"expiresAt","typeLabel":"string"},"endedAt":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"endedAt.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"endedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"endedAt","typeLabel":"string | null"},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"metadata.additionalProperties","typeLabel":"any"},"uniqueKey":"metadata","typeLabel":"object"}},"required":["id","status","connectUrl","settings","runtime","createdAt","startedAt","expiresAt","endedAt"],"additionalProperties":false,"example":{"id":"58e531ee-16ca-49d0-8722-b425d154cc10","status":"running","connectUrl":"wss://api.floppydata.net/v2/browser/sessions/58e531ee-16ca-49d0-8722-b425d154cc10/connect?token=SIGNED_TOKEN","settings":{"id":"f742823c-7ba6-4488-a72d-6e9c5447eacb"},"runtime":{"timeoutSeconds":1800,"keepAlive":true},"metadata":{"taskId":"checkout-42"},"createdAt":"2026-07-10T12:00:00Z","startedAt":"2026-07-10T12:00:01Z","expiresAt":"2026-07-10T12:30:00Z","endedAt":null},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"58e531ee-16ca-49d0-8722-b425d154cc10","status":"running","connectUrl":"wss://api.floppydata.net/v2/browser/sessions/58e531ee-16ca-49d0-8722-b425d154cc10/connect?token=SIGNED_TOKEN","settings":{"id":"f742823c-7ba6-4488-a72d-6e9c5447eacb"},"runtime":{"timeoutSeconds":1800,"keepAlive":true},"metadata":{"taskId":"checkout-42"},"createdAt":"2026-07-10T12:00:00Z","startedAt":"2026-07-10T12:00:01Z","expiresAt":"2026-07-10T12:30:00Z","endedAt":null}}},"exampleType":"generated"}},"exampleType":"generated"},"c755ead8-f12c-4450-84b0-a2c6b6d48421":{"description":"The request body or query parameters are invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"invalid_request","message":"Invalid request parameters.","details":{"issues":[{"path":"country","code":"invalid_format","message":"Expected a 2-letter country code."}]}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"Invalid request parameters.","details":{"issues":[{"path":"country","code":"invalid_format","message":"Expected a 2-letter country code."}]}}}}},"exampleType":"examples"}},"exampleType":"examples"},"62d7d4db-8bce-44b7-92c2-666b557dd31e":{"description":"The API key is missing, invalid, or expired.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"unauthorized","message":"Unauthorized","details":{}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"Unauthorized","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"6e0c9452-2c35-487f-8a02-cf5de6233071":{"description":"The account does not have enough balance for this request.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"insufficient_balance","message":"Insufficient proxy traffic balance.","details":{}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"insufficient_balance","message":"Insufficient proxy traffic balance.","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"6963e156-93f2-48e3-bf43-5a35e87cc258":{"description":"The API key does not grant access to this operation.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"forbidden","message":"Forbidden","details":{}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"forbidden","message":"Forbidden","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"c1f1d5c9-3a25-4059-8054-37117549160e":{"description":"The requested resource is not available.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"not_found","message":"Rotating proxy credential was not found.","details":{}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"not_found","message":"Rotating proxy credential was not found.","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"2c076345-f7a3-4eaf-8118-cf41f4597ed8":{"description":"The authenticated account is not configured for this product.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"account_not_configured","message":"Account is not configured for proxy products.","details":{}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"account_not_configured","message":"Account is not configured for proxy products.","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"ad299892-5ab7-46bc-9310-e6f450985452":{"description":"An unexpected server error occurred.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"internal_error","message":"Internal Server Error","details":{}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"internal_error","message":"Internal Server Error","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"a10586d9-4803-4be4-90ea-38f707d2f3fa":{"description":"An upstream service failed while processing the request.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"upstream_error","message":"Failed to fetch data from an upstream service.","details":{"upstreamStatus":503}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"upstream_error","message":"Failed to fetch data from an upstream service.","details":{"upstreamStatus":503}}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"af1e0e9b-cfa3-42c1-ab39-d4abb4facf41":{"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Client API key for the authenticated account.","scopes":[]}}},"servers":{"5a416e7f-7912-470a-86f6-f1cfb9117df7":{"url":"https://api.floppydata.net","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Client API key for the authenticated account.","scopes":[]},"schema":{"title":"X-Api-Key","type":"string","description":"Client API key for the authenticated account.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyHeader","name":"X-Api-Key"}],"title":"apiKeyHeader"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"floppydata","siteName":"Floppydata Client API","title":"Create a Session - Floppydata Client API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-10T08:48:44.809Z","originalFileLocation":"api-reference/v2/endpoint/browser-session-create.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Creates and starts a browser. The smallest request is {}. Add startUrl to open one or more pages at launch, or navigate with Playwright or Puppeteer after connecting. Supply startUrl as one string of absolute HTTP or HTTPS URLs separated by commas without spaces, up to 2,048 characters total. Omit startUrl when supplying settings.id. Use the returned WebSocket URL to connect, select the tab by URL, and wait for the page content you need.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Floppydata Client API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a Session - Floppydata Client API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates and starts a browser. The smallest request is {}. Add startUrl to open one or more pages at launch, or navigate with Playwright or Puppeteer after connecting. Supply startUrl as one string of absolute HTTP or HTTPS URLs separated by commas without spaces, up to 2,048 characters total. Omit startUrl when supplying settings.id. Use the returned WebSocket URL to connect, select the tab by URL, and wait for the page content you need.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Floppydata Client API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://floppydata.com/docs/api-reference/v2/endpoint/browser-session-create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://floppydata.mintlify.site/docs/_mintlify/api/og/v2?division=Cloud+Browser\u0026amp;title=Create+a+Session\u0026amp;description=Creates+and+starts+a+browser.+The+smallest+request+is+%7B%7D.+Add+startUrl+to+open+one+or+more+pages+at+launch%2C+or+navigate+with+Playwright+or+Puppeteer+after+conne\u0026amp;theme=1fa247ce104f288b8b83ea72\u0026amp;signature=5266864ef4310759b07bc8478d9680376ec1a9a10090d8e1b281d53039a8e65d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a Session - Floppydata Client API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates and starts a browser. The smallest request is {}. Add startUrl to open one or more pages at launch, or navigate with Playwright or Puppeteer after connecting. Supply startUrl as one string of absolute HTTP or HTTPS URLs separated by commas without spaces, up to 2,048 characters total. Omit startUrl when supplying settings.id. Use the returned WebSocket URL to connect, select the tab by URL, and wait for the page content you need.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://floppydata.mintlify.site/docs/_mintlify/api/og/v2?division=Cloud+Browser\u0026amp;title=Create+a+Session\u0026amp;description=Creates+and+starts+a+browser.+The+smallest+request+is+%7B%7D.+Add+startUrl+to+open+one+or+more+pages+at+launch%2C+or+navigate+with+Playwright+or+Puppeteer+after+conne\u0026amp;theme=1fa247ce104f288b8b83ea72\u0026amp;signature=5266864ef4310759b07bc8478d9680376ec1a9a10090d8e1b281d53039a8e65d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Floppydata Client API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://floppydata.com/docs/api-reference/v2/endpoint/browser-session-create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/v2/endpoint/browser-session-create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://floppydata.com/#organization\",\"name\":\"Floppydata Client API\",\"url\":\"https://floppydata.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/floppydata/t-In33JhdHge9jll/logo/light.svg?fit=max\u0026auto=format\u0026n=t-In33JhdHge9jll\u0026q=85\u0026s=2b3535dc315190c13602ee83ea3378c2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://floppydata.com/docs#website\",\"name\":\"Floppydata Client API\",\"url\":\"https://floppydata.com/docs\",\"publisher\":{\"@id\":\"https://floppydata.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://floppydata.com/docs/api-reference/v2/endpoint/browser-session-create#webpage\",\"url\":\"https://floppydata.com/docs/api-reference/v2/endpoint/browser-session-create\",\"name\":\"Create a Session\",\"description\":\"Creates and starts a browser. The smallest request is {}. Add startUrl to open one or more pages at launch, or navigate with Playwright or Puppeteer after connecting. Supply startUrl as one string of absolute HTTP or HTTPS URLs separated by commas without spaces, up to 2,048 characters total. Omit startUrl when supplying settings.id. Use the returned WebSocket URL to connect, select the tab by URL, and wait for the page content you need.\",\"dateModified\":\"2026-09-10T08:48:44.809Z\",\"isPartOf\":{\"@id\":\"https://floppydata.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://floppydata.com/docs/api-reference/v2/endpoint/browser-session-create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://floppydata.com/docs/api-reference/v2/endpoint/browser-session-create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"V2\",\"item\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-search\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a Session\",\"item\":\"https://floppydata.com/docs/api-reference/v2/endpoint/browser-session-create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://floppydata.com/docs/api-reference/v2/endpoint/browser-session-create#apireference\",\"headline\":\"Create a Session\",\"name\":\"Create a Session\",\"description\":\"Creates and starts a browser. The smallest request is {}. Add startUrl to open one or more pages at launch, or navigate with Playwright or Puppeteer after connecting. Supply startUrl as one string of absolute HTTP or HTTPS URLs separated by commas without spaces, up to 2,048 characters total. Omit startUrl when supplying settings.id. Use the returned WebSocket URL to connect, select the tab by URL, and wait for the page content you need.\",\"url\":\"https://floppydata.com/docs/api-reference/v2/endpoint/browser-session-create\",\"mainEntityOfPage\":{\"@id\":\"https://floppydata.com/docs/api-reference/v2/endpoint/browser-session-create#webpage\"},\"dateModified\":\"2026-09-10T08:48:44.809Z\",\"publisher\":{\"@id\":\"https://floppydata.com/#organization\"},\"isPartOf\":{\"@id\":\"https://floppydata.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Floppydata Client API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Floppydata Client API","nav":{"global":null,"tabs":[{"tab":"Start","pages":[{"title":"Start","href":"/overview"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/web-data"}]},{"tab":"API Reference","groups":[{"group":"Overview","root":{"title":"API Reference","href":"/api-reference/introduction"},"pages":[]},{"group":"V2","pages":[{"group":"Web Data","expanded":true,"pages":[{"title":"Search","openapi":"api-reference/openapi.json POST /v2/web-data/search","href":"/api-reference/v2/endpoint/web-data-search"},{"title":"Fetch","openapi":"api-reference/openapi.json POST /v2/web-data/fetch","href":"/api-reference/v2/endpoint/web-data-fetch"},{"title":"Balance","openapi":"api-reference/openapi.json GET /v2/web-data/balance","href":"/api-reference/v2/endpoint/web-data-balance"},{"title":"Usage","openapi":"api-reference/openapi.json GET /v2/web-data/usage","description":"Returns Web Data API usage for the authenticated account as UTC period rollups: yesterday, last7Days, and last30Days. If from or to is supplied, the response also includes requestedRange. Use this for Web Data-only reporting.","href":"/api-reference/v2/endpoint/web-data-usage"}]},{"group":"Cloud Browser","expanded":true,"pages":[{"title":"Create a Session","openapi":"api-reference/openapi.json POST /v2/browser/sessions","href":"/api-reference/v2/endpoint/browser-session-create"},{"title":"Connect to a Session","openapi":"api-reference/openapi.json GET /v2/browser/sessions/{sessionId}/connect","description":"WebSocket relay used by the connectUrl returned from create/get session. It accepts one active relay connection per session.","href":"/api-reference/v2/endpoint/browser-session-connect"},{"title":"Get a Session","openapi":"api-reference/openapi.json GET /v2/browser/sessions/{sessionId}","href":"/api-reference/v2/endpoint/browser-session-get"},{"title":"List Sessions","openapi":"api-reference/openapi.json GET /v2/browser/sessions","href":"/api-reference/v2/endpoint/browser-session-list"},{"title":"Create a Live View","openapi":"api-reference/openapi.json POST /v2/browser/sessions/{sessionId}/live-view","href":"/api-reference/v2/endpoint/browser-session-live-view"},{"title":"Stop a Session","openapi":"api-reference/openapi.json POST /v2/browser/sessions/{sessionId}/stop","href":"/api-reference/v2/endpoint/browser-session-stop"},{"title":"Delete Saved Settings","openapi":"api-reference/openapi.json DELETE /v2/browser/settings/{settingsId}","href":"/api-reference/v2/endpoint/browser-settings-delete"}]},{"group":"Proxy","expanded":true,"pages":[{"group":"Rotating","expanded":true,"pages":[{"title":"Connections","openapi":"api-reference/openapi.json POST /v2/proxy/rotating/connections","href":"/api-reference/v2/endpoint/rotating-connection"},{"title":"List Subusers","openapi":"api-reference/openapi.json GET /v2/proxy/rotating/subusers","href":"/api-reference/v2/endpoint/rotating-subusers-list"},{"title":"Create a Subuser","openapi":"api-reference/openapi.json POST /v2/proxy/rotating/subusers","href":"/api-reference/v2/endpoint/rotating-subusers-create"},{"title":"Delete a Subuser","openapi":"api-reference/openapi.json DELETE /v2/proxy/rotating/subusers/{subuserId}","href":"/api-reference/v2/endpoint/rotating-subusers-delete"},{"title":"Locations","openapi":"api-reference/openapi.json GET /v2/proxy/rotating/locations","href":"/api-reference/v2/endpoint/rotating-locations"},{"title":"Balance","openapi":"api-reference/openapi.json GET /v2/proxy/rotating/balance","href":"/api-reference/v2/endpoint/rotating-balance"},{"title":"Usage","openapi":"api-reference/openapi.json GET /v2/proxy/rotating/usage","href":"/api-reference/v2/endpoint/rotating-usage"}]},{"group":"Static","expanded":true,"pages":[{"title":"List Proxies","openapi":"api-reference/openapi.json GET /v2/proxy/static","href":"/api-reference/v2/endpoint/static-proxies"}]},{"title":"Check Proxy","openapi":"api-reference/openapi.json POST /v2/proxy/check","href":"/api-reference/v2/endpoint/check-proxy"}]},{"group":"Account","expanded":true,"pages":[{"title":"Balances","openapi":"api-reference/openapi.json GET /v2/account/balances","href":"/api-reference/v2/endpoint/account-balances"},{"title":"Usage","openapi":"api-reference/openapi.json GET /v2/account/usage","href":"/api-reference/v2/endpoint/account-usage"}]}]}]},{"tab":"Legacy v1","pages":[{"title":"Legacy v1","href":"/legacy-v1"}]}]},"basePath":"","title":"Create a Session - Floppydata Client API","buildId":"dpl_6dVqRXFR2Go5vF5RLvAdHuv189oT","deploymentId":"dpl_6dVqRXFR2Go5vF5RLvAdHuv189oT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-D_7my4bd.js","utils-Cq_itTNA.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B5KPEvGz.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DBX-JepP.js","snippetPresets-Bsspz-Ge.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-jcs-2nGf.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Dp53in7F.js","shallow-Dv9eUdUd.js","getApiPlaygroundDisplay-D8cDwNhi.js","CodeSnippet-DkwXLQor.js","CodeSnippets-DcSgKqs5.js","Page-t8ynOKTD.js","getPastedJson-I2RjoApV.js","icon-BIj57rZC.js","MethodPill-CTwLPWXC.js","DuplicateIcon-BJpFwygY.js","createIcon-C7PorfAe.js","DynamicMarkdown-BBht_uEs.js","SectionHeading-YIBwxbzj.js","axios-vUo_bRtp.js","Markdown--YCeFtOs.js","clsx-CrPa459s.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BWxsj3I0.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fBzVvq7k.js"]}