Start a browser without a saved profile. The response returns connection fields at the top level. Use the returned internal_uuid to stop the session. Supply a proxy or VPN, or use a pool available to your account. Shared HTTP cache can be enabled separately from profile storage. See the session guide.
POST
/
profiles
/
one_time
Error
A valid request URL is required to generate request examples
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Surfsky","description":"Surfsky cloud browser for automation and scraping","colors":{"primary":"#111111","light":"#ffffff","dark":"#767676"},"logo":{"light":"https://mintcdn.com/llcfzecyberfinity/sOzW2rg1MprciyvQ/images/logo-light.svg?fit=max\u0026auto=format\u0026n=sOzW2rg1MprciyvQ\u0026q=85\u0026s=c6cc1d7d380cb1803815c2369dc6f6c2","dark":"https://mintcdn.com/llcfzecyberfinity/sOzW2rg1MprciyvQ/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=sOzW2rg1MprciyvQ\u0026q=85\u0026s=de57992e58089755f7cd4f3d518da18f","href":"https://surfsky.io"},"favicon":{"light":"https://mintcdn.com/llcfzecyberfinity/sOzW2rg1MprciyvQ/images/favicon-light.svg?fit=max\u0026auto=format\u0026n=sOzW2rg1MprciyvQ\u0026q=85\u0026s=435f78bbb4fbb8acbf012947b73cbaf4","dark":"https://mintcdn.com/llcfzecyberfinity/sOzW2rg1MprciyvQ/images/favicon-dark.svg?fit=max\u0026auto=format\u0026n=sOzW2rg1MprciyvQ\u0026q=85\u0026s=26f98ca931286a0355c2f45a1ea9a892"},"appearance":{"default":"dark"},"background":{"color":{"light":"#ffffff","dark":"#111111"}},"navbar":{"links":[{"href":"https://surfsky.io","label":"Go to Website"}],"primary":{"type":"button","label":"Get Started","href":"https://surfsky.io/signin"}},"footer":{"socials":{"x":"https://x.com/surfskyio","github":"https://github.com/surfskyio","youtube":"https://www.youtube.com/@surfskyio","linkedin":"https://www.linkedin.com/company/surfskyio"}},"seo":{"metatags":{"canonical":"https://docs.surfsky.io","google-site-verification":"J4sdCp8jl5MCOHehI0AOmiPBlLduJLMGQrT4pTNwvU4","msvalidate.01":"C003BE57DE9AE70B5829DB3858FF8609"}},"integrations":{"gtm":{"tagId":"GTM-NX966VJC"}},"contextual":{"options":["copy","view","chatgpt","claude","download-spec"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"llcfzecyberfinity","hasAudioNarration":false,"actualSubdomain":"llcfzecyberfinity","customDomains":["docs.surfsky.io"],"gitSource":{"type":"github","owner":"surfskyio","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aeb8d9cda80903cd692cbc5","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API reference","count":37},{"language":"default","tag":"Documentation","count":37},{"language":"default","tag":"Profiles","count":14},{"language":"default","tag":"CAPTCHA guides","count":12},{"language":"default","tag":"Proxies","count":11},{"language":"default","tag":"Connect your tools","count":6},{"language":"default","tag":"SDKs","count":6},{"language":"default","tag":"Browser sessions","count":5},{"language":"default","tag":"Extensions","count":5},{"language":"default","tag":"Get started","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#content-area span[id]:empty{display:block;scroll-margin-top:var(--scroll-mt, 8rem)}"}],"page":{"pagePath":"api-reference/profiles/start-one-time-session","slug":"/api-reference/profiles/start-one-time-session","pageMetadata":{"title":"Start one-time session","description":"Start a browser without a saved profile. The response returns connection fields at the top level. Use the returned internal_uuid to stop the session. Supply a proxy or VPN, or use a pool available to your account. Shared HTTP cache can be enabled separately from profile storage. See [the session guide](/sessions).","deprecated":null,"version":null,"sidebarTitle":"Start one time session","openapi":"/api-reference/openapi.json post /profiles/one_time","href":"/api-reference/profiles/start-one-time-session","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Start a browser without a saved profile. The response returns connection fields at the top level. Use the returned internal_uuid to stop the session. Supply a proxy or VPN, or use a pool available to your account. Shared HTTP cache can be enabled separately from profile storage. See \", _jsx(_components.a, {\n href: \"/sessions\",\n children: \"the session guide\"\n }), \".\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Start one-time session","description":"Start a browser without a saved profile. The response returns connection fields at the top level. Use the returned internal_uuid to stop the session. Supply a proxy or VPN, or use a pool available to your account. Shared HTTP cache can be enabled separately from profile storage. See [the session guide](/sessions).","deprecated":null,"version":null,"sidebarTitle":"Start one time session","openapi":"/api-reference/openapi.json post /profiles/one_time","href":"/api-reference/profiles/start-one-time-session","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["profiles"],"summary":"Start one-time session","operationId":"start_one_time_profile_profiles_one_time_post","requestBody":"a9ac0931-4947-40ec-a81c-078d78ce3954","responses":{"200":"7afc159f-1416-4ef5-b81c-f10ed27b5acb","401":"477657a2-0b1b-4cdf-b883-30d5e01c326f","403":"c8058a4d-7f48-4a62-a458-cfdcee0bc6a8","422":"33835ebd-1772-4868-b30b-522757c6a579","429":"1a0375a7-904c-4188-be8c-c69b0a691669"},"description":"Start a browser without a saved profile. The response returns connection fields at the top level. Use the returned internal_uuid to stop the session. Supply a proxy or VPN, or use a pool available to your account. Shared HTTP cache can be enabled separately from profile storage. See [the session guide](/sessions).","x-mint":{"href":"/api-reference/profiles/start-one-time-session"},"method":"post","type":"path","servers":["1964c15e-e671-4155-b855-48fbe4031415"],"security":["60f14404-53fd-4b99-993b-6f252ca1c5b1"],"path":"/profiles/one_time","baseUrlOptions":["{baseUrl}"],"title":"Start one-time session","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"properties":{"proxy_blacklist":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"proxy_blacklist.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Proxy Blacklist","uniqueKey":"proxy_blacklist.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Proxy Blacklist","uniqueKey":"proxy_blacklist.oneOf.1","typeLabel":"null"}],"uniqueKey":"proxy_blacklist","typeLabel":"string[] | null"},"domain_routes":{"oneOf":[{"type":"array","items":{"properties":{"proxy":{"type":"string","minLength":1,"format":"uri","title":"Proxy","isRequired":true,"uniqueKey":"domain_routes.oneOf.0.items.[INDEX].proxy","typeLabel":"string\u003curi>"},"domain":{"items":{"type":"string","uniqueKey":"domain_routes.oneOf.0.items.[INDEX].domain.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Domain","uniqueKey":"domain_routes.oneOf.0.items.[INDEX].domain","typeLabel":"string[]"},"domain_suffix":{"items":{"type":"string","uniqueKey":"domain_routes.oneOf.0.items.[INDEX].domain_suffix.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Domain Suffix","uniqueKey":"domain_routes.oneOf.0.items.[INDEX].domain_suffix","typeLabel":"string[]"},"domain_keyword":{"items":{"type":"string","uniqueKey":"domain_routes.oneOf.0.items.[INDEX].domain_keyword.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Domain Keyword","uniqueKey":"domain_routes.oneOf.0.items.[INDEX].domain_keyword","typeLabel":"string[]"},"domain_regex":{"items":{"type":"string","uniqueKey":"domain_routes.oneOf.0.items.[INDEX].domain_regex.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Domain Regex","uniqueKey":"domain_routes.oneOf.0.items.[INDEX].domain_regex","typeLabel":"string[]"}},"type":"object","required":["proxy"],"title":"DomainRouteConfig","description":"Route specific domains through a different proxy.\n\n- domain: exact domain match (e.g., [\"google.com\"])\n- domain_suffix: suffix match (e.g., [\".google.com\"] matches *.google.com)\n- domain_keyword: keyword match (e.g., [\"google\"] matches any domain containing \"google\")\n- domain_regex: regex match (e.g., [\"^stun\\\\..+\"] matches stun.example.com)","uniqueKey":"domain_routes.oneOf.0.items.[INDEX]","typeLabel":"DomainRouteConfig · object"},"title":"Domain Routes","uniqueKey":"domain_routes.oneOf.0","typeLabel":"DomainRouteConfig · object[]"},{"type":"null","title":"Domain Routes","uniqueKey":"domain_routes.oneOf.1","typeLabel":"null"}],"uniqueKey":"domain_routes","typeLabel":"DomainRouteConfig · object[] | null"},"proxy":{"oneOf":[{"type":"string","title":"Proxy","description":"Proxy URL or pool selection. Choose tier explicitly to require shared or premium. See the [proxy guide](/proxies) for targeting rules.","format":"uri","minLength":1,"uniqueKey":"proxy.oneOf.0","typeLabel":"string\u003curi>"},{"type":"object","title":"ProxyConfig","description":"Proxy URL or pool selection. Choose tier explicitly to require shared or premium. See the [proxy guide](/proxies) for targeting rules.","properties":{"tier":{"oneOf":[{"type":"string","title":"ProxyTier","enum":["shared","premium"],"uniqueKey":"proxy.oneOf.1.tier.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"proxy.oneOf.1.tier.oneOf.1","typeLabel":"null"}],"uniqueKey":"proxy.oneOf.1.tier","typeLabel":"enum\u003cstring> | null"},"type":{"oneOf":[{"type":"string","title":"ProxyType","enum":["residential","mobile"],"uniqueKey":"proxy.oneOf.1.type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"proxy.oneOf.1.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"proxy.oneOf.1.type","typeLabel":"enum\u003cstring> | null"},"country":{"oneOf":[{"type":"string","title":"Country","pattern":"^[A-Za-z]{2}$","uniqueKey":"proxy.oneOf.1.country.oneOf.0","typeLabel":"string"},{"type":"null","title":"Country","uniqueKey":"proxy.oneOf.1.country.oneOf.1","typeLabel":"null"}],"uniqueKey":"proxy.oneOf.1.country","typeLabel":"string | null"},"region":{"oneOf":[{"type":"string","title":"Region","pattern":"^[\\w \\-]{1,64}$","uniqueKey":"proxy.oneOf.1.region.oneOf.0","typeLabel":"string"},{"type":"null","title":"Region","uniqueKey":"proxy.oneOf.1.region.oneOf.1","typeLabel":"null"}],"uniqueKey":"proxy.oneOf.1.region","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","title":"City","pattern":"^[\\w \\-]{1,64}$","uniqueKey":"proxy.oneOf.1.city.oneOf.0","typeLabel":"string"},{"type":"null","title":"City","uniqueKey":"proxy.oneOf.1.city.oneOf.1","typeLabel":"null"}],"uniqueKey":"proxy.oneOf.1.city","typeLabel":"string | null"},"pool":{"oneOf":[{"type":"string","title":"RegionalPool","enum":["western","europe","westeurope","northamerica","southamerica","asia","centralasia","southasia","eastasia","sea","oceania","mena","middleeast","africa","northafrica","westafrica","eastafrica","centralafrica","southernafrica"],"uniqueKey":"proxy.oneOf.1.pool.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"proxy.oneOf.1.pool.oneOf.1","typeLabel":"null"}],"uniqueKey":"proxy.oneOf.1.pool","typeLabel":"enum\u003cstring> | null"},"asn":{"oneOf":[{"type":"integer","title":"Asn","maximum":4294967295,"minimum":1,"uniqueKey":"proxy.oneOf.1.asn.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Asn","uniqueKey":"proxy.oneOf.1.asn.oneOf.1","typeLabel":"null"}],"uniqueKey":"proxy.oneOf.1.asn","typeLabel":"integer | null"},"lat":{"oneOf":[{"type":"number","title":"Lat","maximum":90,"minimum":-90,"uniqueKey":"proxy.oneOf.1.lat.oneOf.0","typeLabel":"number"},{"type":"null","title":"Lat","uniqueKey":"proxy.oneOf.1.lat.oneOf.1","typeLabel":"null"}],"uniqueKey":"proxy.oneOf.1.lat","typeLabel":"number | null"},"lon":{"oneOf":[{"type":"number","title":"Lon","maximum":180,"minimum":-180,"uniqueKey":"proxy.oneOf.1.lon.oneOf.0","typeLabel":"number"},{"type":"null","title":"Lon","uniqueKey":"proxy.oneOf.1.lon.oneOf.1","typeLabel":"null"}],"uniqueKey":"proxy.oneOf.1.lon","typeLabel":"number | null"},"session_minutes":{"oneOf":[{"type":"integer","title":"Session Minutes","maximum":10080,"minimum":1,"uniqueKey":"proxy.oneOf.1.session_minutes.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Session Minutes","uniqueKey":"proxy.oneOf.1.session_minutes.oneOf.1","typeLabel":"null"}],"uniqueKey":"proxy.oneOf.1.session_minutes","typeLabel":"integer | null"},"unique_ip":{"type":"boolean","title":"Unique Ip","default":false,"uniqueKey":"proxy.oneOf.1.unique_ip","typeLabel":"boolean"},"keep_asn":{"type":"boolean","title":"Keep Asn","default":false,"uniqueKey":"proxy.oneOf.1.keep_asn","typeLabel":"boolean"},"keep_ip":{"type":"boolean","title":"Keep Ip","default":false,"uniqueKey":"proxy.oneOf.1.keep_ip","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"proxy.oneOf.1","typeLabel":"ProxyConfig · object"},{"type":"null","title":"Proxy","description":"Proxy URL or pool selection. Choose tier explicitly to require shared or premium. See the [proxy guide](/proxies) for targeting rules.","uniqueKey":"proxy.oneOf.2","typeLabel":"null"}],"uniqueKey":"proxy","typeLabel":"string\u003curi> | ProxyConfig · object | null"},"open_vpn":{"oneOf":[{"type":"object","title":"OpenVPNConfig","required":["config"],"properties":{"config":{"type":"string","title":"Config","isRequired":true,"uniqueKey":"open_vpn.oneOf.0.config","typeLabel":"string"},"username":{"type":"string","title":"Username","default":"","uniqueKey":"open_vpn.oneOf.0.username","typeLabel":"string"},"password":{"type":"string","title":"Password","default":"","uniqueKey":"open_vpn.oneOf.0.password","typeLabel":"string"}},"uniqueKey":"open_vpn.oneOf.0","typeLabel":"OpenVPNConfig · object"},{"type":"null","uniqueKey":"open_vpn.oneOf.1","typeLabel":"null"}],"uniqueKey":"open_vpn","typeLabel":"OpenVPNConfig · object | null"},"wireguard":{"oneOf":[{"type":"object","title":"WireGuardConfig","required":["private_key","address","peers"],"properties":{"private_key":{"type":"string","title":"Private Key","isRequired":true,"uniqueKey":"wireguard.oneOf.0.private_key","typeLabel":"string"},"address":{"items":{"type":"string","uniqueKey":"wireguard.oneOf.0.address.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Address","isRequired":true,"uniqueKey":"wireguard.oneOf.0.address","typeLabel":"string[]"},"peers":{"items":{"properties":{"public_key":{"type":"string","title":"Public Key","isRequired":true,"uniqueKey":"wireguard.oneOf.0.peers.items.[INDEX].public_key","typeLabel":"string"},"endpoint":{"type":"string","title":"Endpoint","isRequired":true,"uniqueKey":"wireguard.oneOf.0.peers.items.[INDEX].endpoint","typeLabel":"string"},"allowed_ips":{"items":{"type":"string","uniqueKey":"wireguard.oneOf.0.peers.items.[INDEX].allowed_ips.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Allowed Ips","uniqueKey":"wireguard.oneOf.0.peers.items.[INDEX].allowed_ips","typeLabel":"string[]"},"pre_shared_key":{"oneOf":[{"type":"string","title":"Pre Shared Key","uniqueKey":"wireguard.oneOf.0.peers.items.[INDEX].pre_shared_key.oneOf.0","typeLabel":"string"},{"type":"null","title":"Pre Shared Key","uniqueKey":"wireguard.oneOf.0.peers.items.[INDEX].pre_shared_key.oneOf.1","typeLabel":"null"}],"uniqueKey":"wireguard.oneOf.0.peers.items.[INDEX].pre_shared_key","typeLabel":"string | null"},"persistent_keepalive_interval":{"oneOf":[{"type":"integer","title":"Persistent Keepalive Interval","uniqueKey":"wireguard.oneOf.0.peers.items.[INDEX].persistent_keepalive_interval.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Persistent Keepalive Interval","uniqueKey":"wireguard.oneOf.0.peers.items.[INDEX].persistent_keepalive_interval.oneOf.1","typeLabel":"null"}],"uniqueKey":"wireguard.oneOf.0.peers.items.[INDEX].persistent_keepalive_interval","typeLabel":"integer | null"},"reserved":{"oneOf":[{"type":"array","items":{"type":"integer","uniqueKey":"wireguard.oneOf.0.peers.items.[INDEX].reserved.oneOf.0.items.[INDEX]","typeLabel":"integer"},"title":"Reserved","uniqueKey":"wireguard.oneOf.0.peers.items.[INDEX].reserved.oneOf.0","typeLabel":"integer[]"},{"type":"null","title":"Reserved","uniqueKey":"wireguard.oneOf.0.peers.items.[INDEX].reserved.oneOf.1","typeLabel":"null"}],"uniqueKey":"wireguard.oneOf.0.peers.items.[INDEX].reserved","typeLabel":"integer[] | null"}},"type":"object","required":["public_key","endpoint"],"title":"WireGuardPeerConfig","uniqueKey":"wireguard.oneOf.0.peers.items.[INDEX]","typeLabel":"WireGuardPeerConfig · object"},"type":"array","title":"Peers","isRequired":true,"uniqueKey":"wireguard.oneOf.0.peers","typeLabel":"WireGuardPeerConfig · object[]"},"mtu":{"type":"integer","title":"Mtu","default":1408,"uniqueKey":"wireguard.oneOf.0.mtu","typeLabel":"integer"}},"uniqueKey":"wireguard.oneOf.0","typeLabel":"WireGuardConfig · object"},{"type":"null","uniqueKey":"wireguard.oneOf.1","typeLabel":"null"}],"uniqueKey":"wireguard","typeLabel":"WireGuardConfig · object | null"},"enable_chromedriver":{"type":"boolean","title":"Enable Chromedriver","default":false,"uniqueKey":"enable_chromedriver","typeLabel":"boolean"},"extensions":{"items":{"type":"string","uniqueKey":"extensions.items.[INDEX]","typeLabel":"string"},"type":"array","maxItems":5,"title":"Extensions","uniqueKey":"extensions","typeLabel":"string[]"},"browser_settings":{"properties":{"inactive_kill_timeout":{"type":"integer","maximum":3600,"minimum":1,"title":"Inactive Kill Timeout","default":30,"description":"Seconds without browser activity before automatic stop. An idle WebSocket alone does not keep the session active.","uniqueKey":"browser_settings.inactive_kill_timeout","typeLabel":"integer"},"cache_enabled":{"type":"boolean","title":"Cache Enabled","default":false,"uniqueKey":"browser_settings.cache_enabled","typeLabel":"boolean"},"cache_key":{"oneOf":[{"type":"string","title":"Cache Key","description":"Required when cache_enabled is true. See [shared cache](/shared-cache) for sharing behavior.","maxLength":255,"pattern":"^[A-Za-z0-9_-][A-Za-z0-9._-]*$","uniqueKey":"browser_settings.cache_key.oneOf.0","typeLabel":"string"},{"type":"null","title":"Cache Key","description":"Required when cache_enabled is true. See [shared cache](/shared-cache) for sharing behavior.","uniqueKey":"browser_settings.cache_key.oneOf.1","typeLabel":"null"}],"uniqueKey":"browser_settings.cache_key","typeLabel":"string | null"}},"type":"object","title":"BrowserSettings","uniqueKey":"browser_settings","typeLabel":"BrowserSettings · object"},"fingerprint":{"properties":{"user_agent":{"oneOf":[{"type":"string","title":"User Agent","uniqueKey":"fingerprint.user_agent.oneOf.0","typeLabel":"string"},{"type":"null","title":"User Agent","uniqueKey":"fingerprint.user_agent.oneOf.1","typeLabel":"null"}],"uniqueKey":"fingerprint.user_agent","typeLabel":"string | null"},"screen":{"oneOf":[{"type":"string","title":"Screen","uniqueKey":"fingerprint.screen.oneOf.0","typeLabel":"string"},{"type":"null","title":"Screen","uniqueKey":"fingerprint.screen.oneOf.1","typeLabel":"null"}],"uniqueKey":"fingerprint.screen","typeLabel":"string | null"},"languages":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"fingerprint.languages.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Languages","uniqueKey":"fingerprint.languages.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Languages","uniqueKey":"fingerprint.languages.oneOf.1","typeLabel":"null"}],"uniqueKey":"fingerprint.languages","typeLabel":"string[] | null"},"timezone":{"oneOf":[{"type":"string","title":"Timezone","uniqueKey":"fingerprint.timezone.oneOf.0","typeLabel":"string"},{"type":"null","title":"Timezone","uniqueKey":"fingerprint.timezone.oneOf.1","typeLabel":"null"}],"uniqueKey":"fingerprint.timezone","typeLabel":"string | null"},"geolocation":{"oneOf":[{"type":"object","title":"Geolocation","required":["latitude","longitude","accuracy"],"properties":{"latitude":{"type":"number","maximum":90,"minimum":-90,"title":"Latitude","isRequired":true,"uniqueKey":"fingerprint.geolocation.oneOf.0.latitude","typeLabel":"number"},"longitude":{"type":"number","maximum":180,"minimum":-180,"title":"Longitude","isRequired":true,"uniqueKey":"fingerprint.geolocation.oneOf.0.longitude","typeLabel":"number"},"accuracy":{"type":"integer","maximum":999,"minimum":1,"title":"Accuracy","isRequired":true,"uniqueKey":"fingerprint.geolocation.oneOf.0.accuracy","typeLabel":"integer"}},"uniqueKey":"fingerprint.geolocation.oneOf.0","typeLabel":"Geolocation · object"},{"type":"null","uniqueKey":"fingerprint.geolocation.oneOf.1","typeLabel":"null"}],"uniqueKey":"fingerprint.geolocation","typeLabel":"Geolocation · object | null"},"cpu":{"oneOf":[{"type":"integer","title":"Cpu","uniqueKey":"fingerprint.cpu.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Cpu","uniqueKey":"fingerprint.cpu.oneOf.1","typeLabel":"null"}],"uniqueKey":"fingerprint.cpu","typeLabel":"integer | null"},"ram":{"oneOf":[{"type":"integer","title":"Ram","uniqueKey":"fingerprint.ram.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Ram","uniqueKey":"fingerprint.ram.oneOf.1","typeLabel":"null"}],"uniqueKey":"fingerprint.ram","typeLabel":"integer | null"},"renderer":{"oneOf":[{"type":"string","title":"Renderer","uniqueKey":"fingerprint.renderer.oneOf.0","typeLabel":"string"},{"type":"null","title":"Renderer","uniqueKey":"fingerprint.renderer.oneOf.1","typeLabel":"null"}],"uniqueKey":"fingerprint.renderer","typeLabel":"string | null"},"noise":{"oneOf":[{"type":"object","title":"Noise","additionalProperties":true,"uniqueKey":"fingerprint.noise.oneOf.0","typeLabel":"Noise · object"},{"type":"null","title":"Noise","uniqueKey":"fingerprint.noise.oneOf.1","typeLabel":"null"}],"uniqueKey":"fingerprint.noise","typeLabel":"Noise · object | null"},"dns":{"oneOf":[{"type":"string","title":"Dns","uniqueKey":"fingerprint.dns.oneOf.0","typeLabel":"string"},{"type":"null","title":"Dns","uniqueKey":"fingerprint.dns.oneOf.1","typeLabel":"null"}],"uniqueKey":"fingerprint.dns","typeLabel":"string | null"},"media_devices":{"oneOf":[{"type":"object","title":"Media Devices","additionalProperties":true,"uniqueKey":"fingerprint.media_devices.oneOf.0","typeLabel":"Media Devices · object"},{"type":"null","title":"Media Devices","uniqueKey":"fingerprint.media_devices.oneOf.1","typeLabel":"null"}],"uniqueKey":"fingerprint.media_devices","typeLabel":"Media Devices · object | null"},"webrtc":{"additionalProperties":true,"type":"object","title":"Webrtc","default":{"type":"real"},"uniqueKey":"fingerprint.webrtc","typeLabel":"Webrtc · object"},"os":{"type":"string","enum":["win","mac","android"],"title":"OSTypeIn","default":"win","uniqueKey":"fingerprint.os","typeLabel":"enum\u003cstring>"},"os_arch":{"oneOf":[{"type":"string","title":"Os Arch","uniqueKey":"fingerprint.os_arch.oneOf.0","typeLabel":"string"},{"type":"null","title":"Os Arch","uniqueKey":"fingerprint.os_arch.oneOf.1","typeLabel":"null"}],"uniqueKey":"fingerprint.os_arch","typeLabel":"string | null"},"os_version":{"oneOf":[{"type":"string","title":"Os Version","uniqueKey":"fingerprint.os_version.oneOf.0","typeLabel":"string"},{"type":"null","title":"Os Version","uniqueKey":"fingerprint.os_version.oneOf.1","typeLabel":"null"}],"uniqueKey":"fingerprint.os_version","typeLabel":"string | null"},"device_model":{"oneOf":[{"type":"string","title":"Device Model","uniqueKey":"fingerprint.device_model.oneOf.0","typeLabel":"string"},{"type":"null","title":"Device Model","uniqueKey":"fingerprint.device_model.oneOf.1","typeLabel":"null"}],"uniqueKey":"fingerprint.device_model","typeLabel":"string | null"},"device_type":{"oneOf":[{"type":"string","title":"Device Type","uniqueKey":"fingerprint.device_type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Device Type","uniqueKey":"fingerprint.device_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"fingerprint.device_type","typeLabel":"string | null"}},"additionalProperties":false,"type":"object","title":"OneTimeProfileFingerprint","uniqueKey":"fingerprint","typeLabel":"OneTimeProfileFingerprint · object"},"cookies":{"oneOf":[{"type":"array","items":{"type":"any","uniqueKey":"cookies.oneOf.0.items.[INDEX]","typeLabel":"any"},"title":"Cookies","minItems":1,"uniqueKey":"cookies.oneOf.0","typeLabel":"any[]"},{"type":"null","title":"Cookies","uniqueKey":"cookies.oneOf.1","typeLabel":"null"}],"uniqueKey":"cookies","typeLabel":"any[] | null"},"show_config":{"type":"boolean","title":"Show Config","default":false,"uniqueKey":"show_config","typeLabel":"boolean"}},"additionalProperties":false,"type":"object","title":"StartOneTimeProfileIn","uniqueKey":"","typeLabel":"StartOneTimeProfileIn · object"},"example":{},"examples":{"Example":{"title":"Example","value":{}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"7afc159f-1416-4ef5-b81c-f10ed27b5acb":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"internal_uuid":{"type":"string","description":"Identifier to use for stop, scrape, and live connections. May equal profile_uuid.","isRequired":true,"uniqueKey":"internal_uuid","typeLabel":"string"},"ws_url":{"type":"string","description":"Live CDP connection URL. Keep private.","isRequired":true,"uniqueKey":"ws_url","typeLabel":"string"},"inspector":{"type":"object","properties":{"list":{"type":"string","isRequired":true,"uniqueKey":"inspector.list","typeLabel":"string"},"pages":{"type":"array","items":{"type":"object","properties":{"page_url":{"type":"string","uniqueKey":"inspector.pages.items.[INDEX].page_url","typeLabel":"string"},"devtools_url":{"type":"string","uniqueKey":"inspector.pages.items.[INDEX].devtools_url","typeLabel":"string"}},"uniqueKey":"inspector.pages.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"inspector.pages","typeLabel":"object[]"},"screencast":{"type":"string","isRequired":true,"uniqueKey":"inspector.screencast","typeLabel":"string"}},"required":["list","pages","screencast"],"isRequired":true,"uniqueKey":"inspector","typeLabel":"object"}},"required":["success","internal_uuid","ws_url","inspector"],"uniqueKey":"","typeLabel":"object"},"example":{"success":true,"internal_uuid":"a8fb62f90611456aa75422b01c385a62","ws_url":"wss://YOUR_API_HOST/proxy/a8fb62f90611456aa75422b01c385a62","inspector":{"list":"https://YOUR_API_HOST/proxy/a8fb62f90611456aa75422b01c385a62/inspector","pages":[],"screencast":"wss://YOUR_API_HOST/screencast/a8fb62f90611456aa75422b01c385a62/devtools/page/PAGE_ID"}},"examples":{"Example":{"title":"Example","value":{"success":true,"internal_uuid":"a8fb62f90611456aa75422b01c385a62","ws_url":"wss://YOUR_API_HOST/proxy/a8fb62f90611456aa75422b01c385a62","inspector":{"list":"https://YOUR_API_HOST/proxy/a8fb62f90611456aa75422b01c385a62/inspector","pages":[],"screencast":"wss://YOUR_API_HOST/screencast/a8fb62f90611456aa75422b01c385a62/devtools/page/PAGE_ID"}}}},"exampleType":"examples"}},"exampleType":"examples"},"477657a2-0b1b-4cdf-b883-30d5e01c326f":{"description":"Missing or invalid API token","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":false,"uniqueKey":"success","typeLabel":"boolean"},"msg":{"type":"string","uniqueKey":"msg","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"data":{"oneOf":[{}],"uniqueKey":"data","typeLabel":"any"},"detail":{"oneOf":[{}],"uniqueKey":"detail","typeLabel":"any"},"error":{"oneOf":[{}],"uniqueKey":"error","typeLabel":"any"}},"description":"Error fields vary for forwarded responses. Check HTTP status and code when present.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"msg":"\u003cstring>","code":"\u003cstring>","data":"\u003cunknown>","detail":"\u003cunknown>","error":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"},"c8058a4d-7f48-4a62-a458-cfdcee0bc6a8":{"description":"Account or feature access denied","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":false,"uniqueKey":"success","typeLabel":"boolean"},"msg":{"type":"string","uniqueKey":"msg","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"data":{"oneOf":[{}],"uniqueKey":"data","typeLabel":"any"},"detail":{"oneOf":[{}],"uniqueKey":"detail","typeLabel":"any"},"error":{"oneOf":[{}],"uniqueKey":"error","typeLabel":"any"}},"description":"Error fields vary for forwarded responses. Check HTTP status and code when present.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"msg":"\u003cstring>","code":"\u003cstring>","data":"\u003cunknown>","detail":"\u003cunknown>","error":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"},"33835ebd-1772-4868-b30b-522757c6a579":{"description":"Request validation failed","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":false,"uniqueKey":"success","typeLabel":"boolean"},"msg":{"type":"string","uniqueKey":"msg","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"data":{"oneOf":[{}],"uniqueKey":"data","typeLabel":"any"},"detail":{"oneOf":[{}],"uniqueKey":"detail","typeLabel":"any"},"error":{"oneOf":[{}],"uniqueKey":"error","typeLabel":"any"}},"description":"Error fields vary for forwarded responses. Check HTTP status and code when present.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"msg":"\u003cstring>","code":"\u003cstring>","data":"\u003cunknown>","detail":"\u003cunknown>","error":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"},"1a0375a7-904c-4188-be8c-c69b0a691669":{"description":"Request, browser, session, or traffic limit reached; inspect code","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":false,"uniqueKey":"success","typeLabel":"boolean"},"msg":{"type":"string","uniqueKey":"msg","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"data":{"oneOf":[{}],"uniqueKey":"data","typeLabel":"any"},"detail":{"oneOf":[{}],"uniqueKey":"detail","typeLabel":"any"},"error":{"oneOf":[{}],"uniqueKey":"error","typeLabel":"any"}},"description":"Error fields vary for forwarded responses. Check HTTP status and code when present.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"msg":"\u003cstring>","code":"\u003cstring>","data":"\u003cunknown>","detail":"\u003cunknown>","error":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"60f14404-53fd-4b99-993b-6f252ca1c5b1":{"ApiToken":{"type":"apiKey","in":"header","name":"X-Cloud-Api-Token","description":"API token from your dashboard.","scopes":[],"schemeName":"ApiToken"}}},"servers":{"1964c15e-e671-4155-b855-48fbe4031415":{"url":"{baseUrl}","variables":{"baseUrl":{"default":"https://YOUR_API_HOST","description":"API base URL from your Surfsky dashboard, including https://."}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Cloud-Api-Token","description":"API token from your dashboard.","scopes":[],"schemeName":"ApiToken"},"schema":{"title":"X-Cloud-Api-Token","type":"string","description":"API token from your dashboard.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiToken","name":"X-Cloud-Api-Token"}],"title":"ApiToken"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"llcfzecyberfinity","siteName":"Surfsky","title":"Start one-time session - Surfsky","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-03T17:37:06.654Z","originalFileLocation":"api-reference/profiles/start-one-time-session.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=\"dark\"}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=\"Start a browser without a saved profile. The response returns connection fields at the top level. Use the returned internal_uuid to stop the session. Supply a proxy or VPN, or use a pool available to your account. Shared HTTP cache can be enabled separately from profile storage. See the session guide.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Surfsky\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/llcfzecyberfinity/SHqOt5EXHexpipeW/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/llcfzecyberfinity/SHqOt5EXHexpipeW/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/llcfzecyberfinity/SHqOt5EXHexpipeW/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/llcfzecyberfinity/SHqOt5EXHexpipeW/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/llcfzecyberfinity/SHqOt5EXHexpipeW/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/llcfzecyberfinity/SHqOt5EXHexpipeW/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/llcfzecyberfinity/SHqOt5EXHexpipeW/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/llcfzecyberfinity/SHqOt5EXHexpipeW/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/llcfzecyberfinity/SHqOt5EXHexpipeW/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Start one-time session - Surfsky\">\u003cmeta data-mint-head property=\"og:description\" content=\"Start a browser without a saved profile. The response returns connection fields at the top level. Use the returned internal_uuid to stop the session. Supply a proxy or VPN, or use a pool available to your account. Shared HTTP cache can be enabled separately from profile storage. See the session guide.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Surfsky\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.surfsky.io/api-reference/profiles/start-one-time-session\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://llcfzecyberfinity.mintlify.site/_mintlify/api/og/v2?division=Profiles\u0026amp;title=Start+one-time+session\u0026amp;description=Start+a+browser+without+a+saved+profile.+The+response+returns+connection+fields+at+the+top+level.+Use+the+returned+internal_uuid+to+stop+the+session.+Supply+a+p\u0026amp;theme=b88efaa132919559f01989e9\u0026amp;signature=05910e69a79147cee3ab6a3365aeaeac38b232aa06e3494b5467ab0df04032e9\">\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=\"Start one-time session - Surfsky\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Start a browser without a saved profile. The response returns connection fields at the top level. Use the returned internal_uuid to stop the session. Supply a proxy or VPN, or use a pool available to your account. Shared HTTP cache can be enabled separately from profile storage. See the session guide.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://llcfzecyberfinity.mintlify.site/_mintlify/api/og/v2?division=Profiles\u0026amp;title=Start+one-time+session\u0026amp;description=Start+a+browser+without+a+saved+profile.+The+response+returns+connection+fields+at+the+top+level.+Use+the+returned+internal_uuid+to+stop+the+session.+Supply+a+p\u0026amp;theme=b88efaa132919559f01989e9\u0026amp;signature=05910e69a79147cee3ab6a3365aeaeac38b232aa06e3494b5467ab0df04032e9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/llcfzecyberfinity/SHqOt5EXHexpipeW/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Surfsky\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#111111\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"J4sdCp8jl5MCOHehI0AOmiPBlLduJLMGQrT4pTNwvU4\">\u003cmeta data-mint-head name=\"msvalidate.01\" content=\"C003BE57DE9AE70B5829DB3858FF8609\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.surfsky.io/api-reference/profiles/start-one-time-session\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/profiles/start-one-time-session.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.surfsky.io/#organization\",\"name\":\"Surfsky\",\"url\":\"https://docs.surfsky.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/llcfzecyberfinity/sOzW2rg1MprciyvQ/images/logo-light.svg?fit=max\u0026auto=format\u0026n=sOzW2rg1MprciyvQ\u0026q=85\u0026s=c6cc1d7d380cb1803815c2369dc6f6c2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.surfsky.io#website\",\"name\":\"Surfsky\",\"url\":\"https://docs.surfsky.io\",\"publisher\":{\"@id\":\"https://docs.surfsky.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.surfsky.io/api-reference/profiles/start-one-time-session#webpage\",\"url\":\"https://docs.surfsky.io/api-reference/profiles/start-one-time-session\",\"name\":\"Start one-time session\",\"description\":\"Start a browser without a saved profile. The response returns connection fields at the top level. Use the returned internal_uuid to stop the session. Supply a proxy or VPN, or use a pool available to your account. Shared HTTP cache can be enabled separately from profile storage. See the session guide.\",\"dateModified\":\"2026-11-03T17:37:06.654Z\",\"isPartOf\":{\"@id\":\"https://docs.surfsky.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.surfsky.io/api-reference/profiles/start-one-time-session#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.surfsky.io/api-reference/profiles/start-one-time-session#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Surfsky\",\"item\":\"https://docs.surfsky.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Start one-time session\",\"item\":\"https://docs.surfsky.io/api-reference/profiles/start-one-time-session\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.surfsky.io/api-reference/profiles/start-one-time-session#apireference\",\"headline\":\"Start one-time session\",\"name\":\"Start one-time session\",\"description\":\"Start a browser without a saved profile. The response returns connection fields at the top level. Use the returned internal_uuid to stop the session. Supply a proxy or VPN, or use a pool available to your account. Shared HTTP cache can be enabled separately from profile storage. See the session guide.\",\"url\":\"https://docs.surfsky.io/api-reference/profiles/start-one-time-session\",\"mainEntityOfPage\":{\"@id\":\"https://docs.surfsky.io/api-reference/profiles/start-one-time-session#webpage\"},\"dateModified\":\"2026-11-03T17:37:06.654Z\",\"publisher\":{\"@id\":\"https://docs.surfsky.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.surfsky.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Surfsky\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Surfsky","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdk"}]},{"tab":"API reference","groups":[{"group":"Using the API","pages":[{"title":"API overview","href":"/api-reference"},{"title":"Errors","href":"/errors"}]},{"group":"Scrape","pages":[{"title":"Scrape a page","description":"Load one page in a browser that is already running and return it in the requested formats. The browser runs behind a residential proxy of your region with a desktop fingerprint, solves the challenge pages and captchas it meets and keeps no cookies or storage between requests. One URL per request; on-demand plans only. A request is one session billed in 30-second steps. See [Scraping API](/quickstart/scraping_api).","deprecated":null,"version":null,"sidebarTitle":"Scrape a page","openapi":"/api-reference/openapi.json post /scrape","href":"/api-reference/scrape/scrape-a-page"}]},{"group":"Profiles","pages":[{"title":"Start one-time session","deprecated":null,"version":null,"sidebarTitle":"Start one time session","openapi":"/api-reference/openapi.json post /profiles/one_time","href":"/api-reference/profiles/start-one-time-session"},{"title":"Create profile","description":"Create a saved profile without starting a browser. A title and fingerprint with os are required. The HTTP 201 response contains data.uuid; use it to start the profile. See [persistent profiles](/sessions#persistent-profiles).","deprecated":null,"version":null,"sidebarTitle":"Create profile","openapi":"/api-reference/openapi.json post /profiles","href":"/api-reference/profiles/create-profile"},{"title":"List profiles","deprecated":null,"version":null,"sidebarTitle":"List profiles","openapi":"/api-reference/openapi.json get /profiles","href":"/api-reference/profiles/list-profiles"},{"title":"Get profile","deprecated":null,"version":null,"sidebarTitle":"Get profile","openapi":"/api-reference/openapi.json get /profiles/{profile_uuid}","href":"/api-reference/profiles/get-profile"},{"title":"Update profile","deprecated":null,"version":null,"sidebarTitle":"Update profile","openapi":"/api-reference/openapi.json patch /profiles/{profile_uuid}","href":"/api-reference/profiles/update-profile"},{"title":"Delete profile","deprecated":null,"version":null,"sidebarTitle":"Delete profile","openapi":"/api-reference/openapi.json delete /profiles/{profile_uuid}","href":"/api-reference/profiles/delete-profile"},{"title":"Delete profiles","deprecated":null,"version":null,"sidebarTitle":"Delete profiles","openapi":"/api-reference/openapi.json delete /profiles","href":"/api-reference/profiles/delete-profiles"},{"title":"Start profile","deprecated":null,"version":null,"sidebarTitle":"Start profile","openapi":"/api-reference/openapi.json post /profiles/{profile_uuid}/start","href":"/api-reference/profiles/start-profile"},{"title":"Stop session","deprecated":null,"version":null,"sidebarTitle":"Stop session","openapi":"/api-reference/openapi.json post /profiles/{internal_uuid}/stop","href":"/api-reference/profiles/stop-session"},{"title":"Stop all sessions","deprecated":null,"version":null,"sidebarTitle":"Stop all sessions","openapi":"/api-reference/openapi.json post /profiles/stop","href":"/api-reference/profiles/stop-all-sessions"},{"title":"List active sessions","deprecated":null,"version":null,"sidebarTitle":"List active sessions","openapi":"/api-reference/openapi.json get /profiles/active","href":"/api-reference/profiles/list-active-sessions"},{"title":"Scrape page","deprecated":null,"version":null,"sidebarTitle":"Scrape page","openapi":"/api-reference/openapi.json post /profiles/{internal_uuid}/scrape","href":"/api-reference/profiles/scrape-page"},{"title":"Export cookies","deprecated":null,"version":null,"sidebarTitle":"Export cookies","openapi":"/api-reference/openapi.json get /profiles/{profile_uuid}/cookies","href":"/api-reference/profiles/export-cookies"},{"title":"Import cookies","deprecated":null,"version":null,"sidebarTitle":"Import cookies","openapi":"/api-reference/openapi.json post /profiles/{profile_uuid}/cookies","href":"/api-reference/profiles/import-cookies"}]},{"group":"Proxies","pages":[{"title":"List proxy pools","deprecated":null,"version":null,"sidebarTitle":"List proxy pools","openapi":"/api-reference/openapi.json get /proxies/pools","href":"/api-reference/proxies/list-proxy-pools"},{"title":"List premium countries","deprecated":null,"version":null,"sidebarTitle":"List premium countries","openapi":"/api-reference/openapi.json get /proxies/countries","href":"/api-reference/proxies/list-premium-countries"},{"title":"List premium regions","deprecated":null,"version":null,"sidebarTitle":"List premium regions","openapi":"/api-reference/openapi.json get /proxies/regions/{country}","href":"/api-reference/proxies/list-premium-regions"},{"title":"List premium cities","deprecated":null,"version":null,"sidebarTitle":"List premium cities","openapi":"/api-reference/openapi.json get /proxies/cities/{country}/{region}","href":"/api-reference/proxies/list-premium-cities"},{"title":"List premium ASNs","deprecated":null,"version":null,"sidebarTitle":"List premium asns","openapi":"/api-reference/openapi.json get /proxies/asns/{country}","href":"/api-reference/proxies/list-premium-asns"},{"title":"List shared countries","deprecated":null,"version":null,"sidebarTitle":"List shared countries","openapi":"/api-reference/openapi.json get /proxies/shared/countries","href":"/api-reference/proxies/list-shared-countries"},{"title":"Get traffic quota","deprecated":null,"version":null,"sidebarTitle":"Get traffic quota","openapi":"/api-reference/openapi.json get /proxies/quota","href":"/api-reference/proxies/get-traffic-quota"},{"title":"Get premium quota","deprecated":null,"version":null,"sidebarTitle":"Get premium quota","openapi":"/api-reference/openapi.json get /proxies/premium/quota","href":"/api-reference/proxies/get-premium-quota"},{"title":"Get premium traffic stats","deprecated":null,"version":null,"sidebarTitle":"Get premium traffic stats","openapi":"/api-reference/openapi.json get /proxies/premium/stats","href":"/api-reference/proxies/get-premium-traffic-stats"},{"title":"Get shared quota","deprecated":null,"version":null,"sidebarTitle":"Get shared quota","openapi":"/api-reference/openapi.json get /proxies/shared/quota","href":"/api-reference/proxies/get-shared-quota"},{"title":"Get shared traffic stats","deprecated":null,"version":null,"sidebarTitle":"Get shared traffic stats","openapi":"/api-reference/openapi.json get /proxies/shared/stats","href":"/api-reference/proxies/get-shared-traffic-stats"}]},{"group":"Fingerprints","pages":[{"title":"List renderers","deprecated":null,"version":null,"sidebarTitle":"List renderers","openapi":"/api-reference/openapi.json get /fingerprint/renderers","href":"/api-reference/fingerprints/list-renderers"},{"title":"List screens","deprecated":null,"version":null,"sidebarTitle":"List screens","openapi":"/api-reference/openapi.json get /fingerprint/screens","href":"/api-reference/fingerprints/list-screens"},{"title":"List device models","deprecated":null,"version":null,"sidebarTitle":"List device models","openapi":"/api-reference/openapi.json get /fingerprint/device_models","href":"/api-reference/fingerprints/list-device-models"}]},{"group":"Extensions","pages":[{"title":"Upload extension","deprecated":null,"version":null,"sidebarTitle":"Upload extension","openapi":"/api-reference/openapi.json post /extensions","href":"/api-reference/extensions/upload-extension"},{"title":"List extensions","deprecated":null,"version":null,"sidebarTitle":"List extensions","openapi":"/api-reference/openapi.json get /extensions","href":"/api-reference/extensions/list-extensions"},{"title":"Get extension","deprecated":null,"version":null,"sidebarTitle":"Get extension","openapi":"/api-reference/openapi.json get /extensions/{extension_uuid}","href":"/api-reference/extensions/get-extension"},{"title":"Update extension","deprecated":null,"version":null,"sidebarTitle":"Update extension","openapi":"/api-reference/openapi.json patch /extensions/{extension_uuid}","href":"/api-reference/extensions/update-extension"},{"title":"Delete extension","deprecated":null,"version":null,"sidebarTitle":"Delete extension","openapi":"/api-reference/openapi.json delete /extensions/{extension_uuid}","href":"/api-reference/extensions/delete-extension"}]},{"group":"Site reports","pages":[{"title":"Report a blocked site","deprecated":null,"version":null,"sidebarTitle":"Report a blocked site","openapi":"/api-reference/openapi.json post /site-reports","href":"/api-reference/site-reports/report-a-blocked-site"}]}]}]},"basePath":"","title":"Start one-time session - Surfsky","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}