{"openapi":"3.1.0","info":{"title":"Notte API","description":"Notte API is a REST API that allows you to interact with Notte. It is used to create cloud browser sessions, scrape webpages, and run web ai agents to act on your behalf on the internet.","version":"1.4.40","x-logo":{"url":"https://www.notte.cc/images/logo/logo-white.png"}},"paths":{"/sessions":{"get":{"tags":["sessions"],"summary":"List Sessions","operationId":"list_sessions","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of items per page","default":10,"title":"Page Size"},"description":"Number of items per page"},{"name":"only_active","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return active sessions","default":true,"title":"Only Active"},"description":"Whether to only return active sessions"},{"name":"only_current_token","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return sessions for the current token (apikey)","default":false,"title":"Only Current Token"},"description":"Whether to only return sessions for the current token (apikey)"},{"name":"include_system","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to include internal system sessions","default":true,"title":"Include System"},"description":"Whether to include internal system sessions"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_SessionResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/sessions/start":{"post":{"tags":["sessions"],"summary":"Session Start","operationId":"session_start","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiSessionStartRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"from notte_sdk import NotteClient, actions\n\nnotte = NotteClient()\n# the simple way: create a session that gets stopped automatically\nwith notte.Session() as session:\n    _ = session.execute(\n        actions.Goto(url=\"https://www.google.com\")\n    )\n\n# for more control, start it manually\nsession = notte.Session()\nsession.start()","label":"python"},{"lang":"JavaScript","source":"import { NotteClient } from \"notte-sdk\";\n\nconst notte = new NotteClient();\n// the simple way: create a session that gets stopped automatically\nawait notte.Session().use(async (session) => {\n  await session.execute({\n    type: \"goto\",\n    url: \"https://www.google.com\",\n  });\n});\n\n// for more control, start it manually\nconst session = notte.Session();\nawait session.start();","label":"node"},{"lang":"Curl","source":"curl -X POST \"https://api.notte.cc/sessions/start\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\" \\\n-d '{\n\"headless\": true,\n\"solve_captchas\": false,\n\"timeout_minutes\": 3,\n\"proxies\": false,\n\"browser_type\": \"chromium\",\n\"user_agent\": null,\n\"chrome_args\": null,\n\"viewport_width\": null,\n\"viewport_height\": null,\n\"cdp_url\": null,\n\"screenshot_type\": \"last_action\"\n}'","label":"curl"}]}},"/sessions/{session_id}":{"get":{"tags":["sessions"],"summary":"Session Status","operationId":"session_status","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/sessions/{session_id}/workflow/code":{"get":{"tags":["sessions"],"summary":"Get Session Script","operationId":"get_session_script","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"as_workflow","in":"query","required":true,"schema":{"type":"boolean","description":"Whether to return code as standalone workflow or just relevant instructions","title":"As Workflow"},"description":"Whether to return code as standalone workflow or just relevant instructions"},{"name":"infer_response_format","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to infer response_format schema for scrape calls that have instructions but no schema","default":false,"title":"Infer Response Format"},"description":"Whether to infer response_format schema for scrape calls that have instructions but no schema"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentFunctionCodeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/sessions/{session_id}/stop":{"delete":{"tags":["sessions"],"summary":"Session Stop","operationId":"session_stop","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"close_reason","in":"query","required":false,"schema":{"enum":["manual","error"],"type":"string","default":"manual","title":"Close Reason"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"from notte_sdk import NotteClient\n\nnotte = NotteClient()\n# for more control, start it manually\nsession = notte.Session(session_id=\"<session_id>\")\n# stop it manually\nsession.stop()","label":"python"},{"lang":"Curl","source":"curl -X DELETE \"https://api.notte.cc/sessions/$session_id/stop\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\"","label":"curl"}]}},"/sessions/{session_id}/cookies":{"post":{"tags":["sessions"],"summary":"Session Cookies Set","operationId":"session_cookies_set","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"update_metadata","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Update Metadata"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_session_cookies_set_sessions__session_id__cookies_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"import json\nfrom notte_sdk import NotteClient\n\nnotte = NotteClient()\n# load the cookies from json and inject them in the session\nwith open(\"cookies.json\", \"r\") as f:\n    cookies = json.load(f)\n\nwith notte.Session() as session:\n    cookies = session.set_cookies(cookies)","label":"python"},{"lang":"JavaScript","source":"import { NotteClient } from \"notte-sdk\";\nimport { readFileSync } from \"fs\";\n\nconst notte = new NotteClient();\n// load the cookies from json and inject them in the session\nconst cookies = JSON.parse(readFileSync(\"cookies.json\", \"utf-8\"));\n\nawait notte.Session().use(async (session) => {\n  await session.setCookies(cookies);\n});","label":"node"},{"lang":"Curl","source":"curl -X POST \"https://api.notte.cc/sessions/$session_id/cookies\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\" \\\n-d '{\n\"cookies\": [\n{\n\"name\": \"name\",\n\"value\": \"value\",\n\"domain\": \".googl.com\",\n\"path\": \"/\",\n\"httpOnly\": false,\n\"hostOnly\": null,\n\"sameSite\": \"Lax\",\n\"secure\": true,\n\"session\": null,\n\"storeId\": null,\n\"expires\": -1\n}\n]\n}'","label":"curl"}]},"get":{"tags":["sessions"],"summary":"Session Cookies Get","operationId":"session_cookies_get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"update_metadata","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Update Metadata"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCookiesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"import json\nfrom notte_sdk import NotteClient\n\nnotte = NotteClient()\nwith notte.Session() as session:\n    # perform some operation that creates cookies\n    # ...\n    # then save the cookies to json\n    cookies = session.get_cookies()\n    with open(\"cookies.json\", \"w\") as f:\n        json.dump(cookies, f)","label":"python"},{"lang":"JavaScript","source":"import { NotteClient } from \"notte-sdk\";\nimport { writeFileSync } from \"fs\";\n\nconst notte = new NotteClient();\nawait notte.Session().use(async (session) => {\n  // perform some operation that creates cookies\n  // ...\n  // then save the cookies to json\n  const cookies = await session.getCookies();\n  writeFileSync(\"cookies.json\", JSON.stringify(cookies));\n});","label":"node"},{"lang":"Curl","source":"curl -X GET \"https://api.notte.cc/sessions/$session_id/cookies\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\"","label":"curl"}]}},"/sessions/{session_id}/debug":{"get":{"tags":["sessions","debug"],"summary":"Session Debug Info","operationId":"session_debug_info","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"update_metadata","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Update Metadata"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionDebugResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/sessions/{session_id}/offset":{"get":{"tags":["sessions","debug"],"summary":"Session Offset","operationId":"session_offset","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionOffsetResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/sessions/{session_id}/page/observe":{"post":{"tags":["sessions","page"],"summary":"Page Observe","operationId":"page_observe","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"update_metadata","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Update Metadata"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObserveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Observation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"from notte_sdk import NotteClient, actions\n\nnotte = NotteClient()\nwith notte.Session() as session:\n    # Observe the state of a webpage\n\n    _ = session.execute(\n        actions.Goto(url=\"https://google.com/travel/flights\")\n    )\n    obs = session.observe()\n    print(\"Page Title:\", obs.metadata.title)\n    print(\n        \"Available Actions:\\n\",\n        obs.space.description,\n    )\n    # # Example Output:\n    # # Flight Search\n    # * I1: Enter departure location\n    # ...","label":"python"},{"lang":"JavaScript","source":"import { NotteClient } from \"notte-sdk\";\n\nconst notte = new NotteClient();\nawait notte.Session().use(async (session) => {\n  // Observe the state of a webpage\n  await session.execute({\n    type: \"goto\",\n    url: \"https://google.com/travel/flights\",\n  });\n  const obs = await session.observe();\n  console.log(\"Page Title:\", obs.metadata.title);\n  console.log(\n    \"Available Actions:\\n\",\n    obs.space.description\n  );\n  // Example Output:\n  // Flight Search\n  // * I1: Enter departure location\n  // ...\n});","label":"node"},{"lang":"Curl","source":"curl -X POST \"https://api.notte.cc/sessions/$session_id/page/observe\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\" \\\n-d '{\n\"min_nb_actions\": null,\n\"max_nb_actions\": 100,\n\"instructions\": null,\n\"perception_type\": null\n}'","label":"curl"}]}},"/sessions/{session_id}/page/screenshot":{"post":{"tags":["sessions","page"],"summary":"Page Screenshot","operationId":"page_screenshot","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"update_metadata","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Update Metadata"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/sessions/{session_id}/page/execute":{"post":{"tags":["sessions","page"],"summary":"Page Execute","operationId":"page_execute","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"update_metadata","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Update Metadata"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/FormFillAction"},{"$ref":"#/components/schemas/GotoAction"},{"$ref":"#/components/schemas/GotoNewTabAction"},{"$ref":"#/components/schemas/CloseTabAction"},{"$ref":"#/components/schemas/SwitchTabAction"},{"$ref":"#/components/schemas/GoBackAction"},{"$ref":"#/components/schemas/GoForwardAction"},{"$ref":"#/components/schemas/ReloadAction"},{"$ref":"#/components/schemas/WaitAction"},{"$ref":"#/components/schemas/PressKeyAction"},{"$ref":"#/components/schemas/ScrollUpAction"},{"$ref":"#/components/schemas/ScrollDownAction"},{"$ref":"#/components/schemas/CaptchaSolveAction"},{"$ref":"#/components/schemas/HelpAction"},{"$ref":"#/components/schemas/CompletionAction"},{"$ref":"#/components/schemas/ScrapeAction"},{"$ref":"#/components/schemas/EmailReadAction"},{"$ref":"#/components/schemas/EmailVerificationReadAction"},{"$ref":"#/components/schemas/SmsReadAction"},{"$ref":"#/components/schemas/EvaluateJsAction"},{"$ref":"#/components/schemas/ClickAction-Input"},{"$ref":"#/components/schemas/FillAction-Input"},{"$ref":"#/components/schemas/MultiFactorFillAction-Input"},{"$ref":"#/components/schemas/FallbackFillAction-Input"},{"$ref":"#/components/schemas/CheckAction-Input"},{"$ref":"#/components/schemas/SelectDropdownOptionAction-Input"},{"$ref":"#/components/schemas/UploadFileAction-Input"},{"$ref":"#/components/schemas/DownloadFileAction-Input"}],"discriminator":{"propertyName":"type","mapping":{"form_fill":"#/components/schemas/FormFillAction","goto":"#/components/schemas/GotoAction","goto_new_tab":"#/components/schemas/GotoNewTabAction","close_tab":"#/components/schemas/CloseTabAction","switch_tab":"#/components/schemas/SwitchTabAction","go_back":"#/components/schemas/GoBackAction","go_forward":"#/components/schemas/GoForwardAction","reload":"#/components/schemas/ReloadAction","wait":"#/components/schemas/WaitAction","press_key":"#/components/schemas/PressKeyAction","scroll_up":"#/components/schemas/ScrollUpAction","scroll_down":"#/components/schemas/ScrollDownAction","captcha_solve":"#/components/schemas/CaptchaSolveAction","help":"#/components/schemas/HelpAction","completion":"#/components/schemas/CompletionAction","scrape":"#/components/schemas/ScrapeAction","email_read":"#/components/schemas/EmailReadAction","email_verification_read":"#/components/schemas/EmailVerificationReadAction","sms_read":"#/components/schemas/SmsReadAction","evaluate_js":"#/components/schemas/EvaluateJsAction","click":"#/components/schemas/ClickAction-Input","fill":"#/components/schemas/FillAction-Input","multi_factor_fill":"#/components/schemas/MultiFactorFillAction-Input","fallback_fill":"#/components/schemas/FallbackFillAction-Input","check":"#/components/schemas/CheckAction-Input","select_dropdown_option":"#/components/schemas/SelectDropdownOptionAction-Input","upload_file":"#/components/schemas/UploadFileAction-Input","download_file":"#/components/schemas/DownloadFileAction-Input"}},"title":"Action"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiExecutionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"from notte_sdk import NotteClient, actions\n\nnotte = NotteClient()\nwith notte.Session() as session:\n    # go to DuckDuckGo\n    _ = session.execute(actions.Goto(url=\"https://www.duckduckgo.com\"))\n\n    # fill the search bar with our query\n    _ = session.execute(\n        actions.Fill(\n            value=\"dog pictures\",\n            selector='textarea[name=\"q\"][aria-label=\"Search with DuckDuckGo\"]',\n        )\n    )","label":"python"},{"lang":"JavaScript","source":"import { NotteClient } from \"notte-sdk\";\n\nconst notte = new NotteClient();\nawait notte.Session().use(async (session) => {\n  // go to duckduckgo\n  await session.execute({\n    type: \"goto\",\n    url: \"https://www.duckduckgo.com\",\n  });\n\n  // fill the search bar with our query\n  await session.execute({\n    type: \"fill\",\n    value: \"dog pictures\",\n    selector: 'textarea[name=\"q\"][aria-label=\"Search with DuckDuckGo\"]',\n  });\n});","label":"node"},{"lang":"Curl","source":"curl --X POST \"https://api.notte.cc/sessions/$session_id/page/execute\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\" \\\n-d '{\n    \"type\": \"goto\",\n    \"url\": \"https://www.duckduckgo.com\"\n}'","label":"curl"}]}},"/sessions/{session_id}/page/scrape":{"post":{"tags":["sessions","page"],"summary":"Page Scrape","operationId":"page_scrape","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"update_metadata","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Update Metadata"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScrapeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSpace"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"from notte_sdk import NotteClient, actions\nfrom pydantic import BaseModel\n\n\nclass StoryInfo(BaseModel):\n    title: str\n    points: int | None = None\n\n\nclass Stories(BaseModel):\n    stories: list[StoryInfo]\n\n\nnotte = NotteClient()\nwith notte.Session() as session:\n    _ = session.execute(actions.Goto(url=\"https://news.ycombinator.com\"))\n    stories = session.scrape(\n        instructions=\"Extract the top 5 story titles and their points\",\n        response_format=Stories,\n    )","label":"python"},{"lang":"JavaScript","source":"import { NotteClient } from \"notte-sdk\";\nimport { z } from \"zod\";\n\nconst StoryInfo = z.object({\n  title: z.string(),\n  points: z.number().nullable(),\n});\n\nconst Stories = z.object({\n  stories: z.array(StoryInfo),\n});\n\nconst notte = new NotteClient();\nawait notte.Session().use(async (session) => {\n  await session.execute({\n    type: \"goto\",\n    url: \"https://news.ycombinator.com\",\n  });\n  const stories = await session.scrape({\n    instructions:\n      \"Extract the top 5 story titles and their points\",\n    response_format: Stories,\n  });\n});","label":"node"},{"lang":"Curl","source":"curl -X POST \"https://api.notte.cc/sessions/$session_id/page/scrape\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\" \\\n-d '{\n\"scrape_links\": true,\n\"scrape_images\": false,\n\"ignored_tags\": null,\n\"only_main_content\": true,\n\"only_images\": false,\n\"response_format\": null,\n\"instructions\": null,\n\"use_link_placeholders\": false\n}'","label":"curl"}]}},"/sessions/{session_id}/network/logs":{"get":{"tags":["sessions","network"],"summary":"Session Network Logs","operationId":"session_network_logs","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Maximum number of batch files to return","default":100,"title":"Limit"},"description":"Maximum number of batch files to return"},{"name":"download","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to include download URLs for the logs","default":true,"title":"Download"},"description":"Whether to include download URLs for the logs"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkLogsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/sessions/{session_id}/replay":{"get":{"tags":["sessions","replay"],"summary":"Session Replay","operationId":"session_replay","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplayResponse"}}}},"404":{"description":"Replay missing; see replay_status and retryable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplayMissingResponse"}}}},"410":{"description":"Capture completed without any frames.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplayMissingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/sessions/{session_id}/files":{"post":{"tags":["sessions","files"],"summary":"Upload Session File","operationId":"upload_session_file","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_session_file_sessions__session_id__files_post"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionFile"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]},"get":{"tags":["sessions","files"],"summary":"List Session Files","operationId":"list_session_files","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/FileSource"},{"type":"null"}],"title":"Source"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionFilesPage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/sessions/{session_id}/files/{file_id}":{"get":{"tags":["sessions","files"],"summary":"Download Session File","operationId":"download_session_file","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"File Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}},"application/octet-stream":{}}},"410":{"description":"File expired"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]},"delete":{"tags":["sessions","files"],"summary":"Delete Session File","operationId":"delete_session_file","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"File Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/agents/start":{"post":{"tags":["agents"],"summary":"Agent Start","operationId":"agent_start","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiAgentStartRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"from notte_sdk import NotteClient\n\nnotte = NotteClient()\ntask = \"find a cute dog on google images\"\n\nwith notte.Session() as session:\n    agent = notte.Agent(session=session, max_steps=5)\n    # this runs the agent and waits for completion\n    full_response = agent.run(task=task)\n    print(f\"{full_response.success=}, {full_response.answer=}\")","label":"python"},{"lang":"JavaScript","source":"import { NotteClient } from \"notte-sdk\";\n\nconst notte = new NotteClient();\nconst task = \"find a cute dog on google images\";\n\nawait notte.Session().use(async (session) => {\n  const agent = notte.Agent({ session, max_steps: 5 });\n  // this runs the agent and waits for completion\n  const response = await agent.run({ task });\n  console.log(`success=${response.success}, answer=${response.answer}`);\n});","label":"node"},{"lang":"Curl","source":"curl -X POST \"https://api.notte.cc/agents/start\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\" \\\n-d '{\n\"task\": \"task\",\n\"url\": null,\n\"response_format\": null,\n\"session_offset\": null,\n\"reasoning_model\": \"vertex_ai/gemini-2.5-flash\",\n\"use_vision\": true,\n\"max_steps\": 20,\n\"vault_id\": null,\n\"persona_id\": null,\n\"notifier_config\": null,\n\"session_id\": \"<session_id>\"\n}'","label":"curl"}]}},"/agents/{agent_id}":{"get":{"tags":["agents"],"summary":"Agent Status","operationId":"agent_status","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegacyAgentStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/agents/{agent_id}/workflow/code":{"get":{"tags":["agents"],"summary":"Get Script","operationId":"get_script","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"as_workflow","in":"query","required":true,"schema":{"type":"boolean","description":"Whether to return code as standalone workflow or just relevant instructions","title":"As Workflow"},"description":"Whether to return code as standalone workflow or just relevant instructions"},{"name":"infer_response_format","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to infer response_format schema for scrape calls that have instructions but no schema","default":false,"title":"Infer Response Format"},"description":"Whether to infer response_format schema for scrape calls that have instructions but no schema"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentFunctionCodeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"from notte_sdk import NotteClient\n\nnotte = NotteClient()\n\nagent = notte.Agent(agent_id=\"<agent_id>\")\nprint(agent.workflow.code())","label":"python"},{"lang":"Curl","source":"curl -X GET \"https://api.notte.cc/agents/$agent_id/workflow/code?as_workflow=false\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\"","label":"curl"}]}},"/agents/{agent_id}/stop":{"delete":{"tags":["agents"],"summary":"Agent Stop","operationId":"agent_stop","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"session_id","in":"query","required":true,"schema":{"type":"string","minLength":1,"title":"Session Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"from notte_sdk import NotteClient\n\nnotte = NotteClient()\n\nwith notte.Session() as session:\n    agent = notte.Agent(session=session)\n    _ = agent.start(\n        task=\"find a cute dog on google images\"\n    )\n\n    # stops without waiting for the agent to finish\n    _ = agent.stop()","label":"python"},{"lang":"JavaScript","source":"import { NotteClient } from \"notte-sdk\";\n\nconst notte = new NotteClient();\n\nawait notte.Session().use(async (session) => {\n  const agent = notte.Agent({ session });\n  await agent.start({\n    task: \"find a cute dog on google images\",\n  });\n\n  // stops without waiting for the agent to finish\n  await agent.stop();\n});","label":"node"},{"lang":"Curl","source":"curl -X DELETE \"https://api.notte.cc/agents/$agent_id/stop?session_id=${session_id}\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\"","label":"curl"}]}},"/agents":{"get":{"tags":["agents"],"summary":"List Agents","operationId":"list_agents","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of items per page","default":10,"title":"Page Size"},"description":"Number of items per page"},{"name":"only_active","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return active sessions","default":true,"title":"Only Active"},"description":"Whether to only return active sessions"},{"name":"only_saved","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return saved agents","default":false,"title":"Only Saved"},"description":"Whether to only return saved agents"},{"name":"only_current_token","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return agents for the current token (apikey)","default":false,"title":"Only Current Token"},"description":"Whether to only return agents for the current token (apikey)"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_AgentResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/functions/health":{"get":{"tags":["functions"],"summary":"Function Runtime Health","operationId":"function_runtime_health","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FunctionRuntimeHealthResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/functions":{"post":{"tags":["functions"],"summary":"Function Create","operationId":"function_create","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"restricted","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to restrict the function code","default":true,"title":"Restricted"},"description":"Whether to restrict the function code"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_function_create_functions_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FunctionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true},"get":{"tags":["functions"],"summary":"List Functions","operationId":"list_functions","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of items per page","default":10,"title":"Page Size"},"description":"Number of items per page"},{"name":"only_active","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return active sessions","default":true,"title":"Only Active"},"description":"Whether to only return active sessions"},{"name":"only_current_token","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return sessions for the current token (apikey)","default":false,"title":"Only Current Token"},"description":"Whether to only return sessions for the current token (apikey)"},{"name":"include_system","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to include internal system sessions","default":true,"title":"Include System"},"description":"Whether to include internal system sessions"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_FunctionListItemResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/functions/{function_id}":{"post":{"tags":["functions"],"summary":"Function Update","operationId":"function_update","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"function_id","in":"path","required":true,"schema":{"type":"string","title":"Function Id"}},{"name":"version","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The version of the function to upload","title":"Version"},"description":"The version of the function to upload"},{"name":"restricted","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to restrict the function code","default":true,"title":"Restricted"},"description":"Whether to restrict the function code"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_function_update_functions__function_id__post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FunctionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true},"patch":{"tags":["functions"],"summary":"Function Metadata Update","operationId":"function_metadata_update","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"function_id","in":"path","required":true,"schema":{"type":"string","title":"Function Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FunctionMetadataUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FunctionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true},"get":{"tags":["functions"],"summary":"Function Download Url","operationId":"function_download_url","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"function_id","in":"path","required":true,"schema":{"type":"string","title":"Function Id"}},{"name":"version","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"}},{"name":"decryption_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The decryption key for the function","title":"Decryption Key"},"description":"The decryption key for the function"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FunctionWithLinkResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true},"delete":{"tags":["functions"],"summary":"Function Delete","operationId":"function_delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"function_id","in":"path","required":true,"schema":{"type":"string","title":"Function Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteFunctionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/functions/{function_id}/fork":{"post":{"tags":["functions"],"summary":"Function Fork","operationId":"function_fork","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"function_id","in":"path","required":true,"schema":{"type":"string","title":"Function Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FunctionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"from notte_sdk import NotteClient\n\nnotte = NotteClient()\nfn = notte.Function(\"<public_function_id>\")\n# creates a private copy of the function (only works for public functions)\nfn = fn.fork()","label":"python"}]}},"/functions/{function_id}/rollback":{"post":{"tags":["functions"],"summary":"Function Rollback","operationId":"function_rollback","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"function_id","in":"path","required":true,"schema":{"type":"string","title":"Function Id"}},{"name":"restricted","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to restrict the function code","default":true,"title":"Restricted"},"description":"Whether to restrict the function code"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FunctionRollbackRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FunctionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/functions/{function_id}/schedule":{"post":{"tags":["functions"],"summary":"Function Schedule Set","operationId":"function_schedule_set","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"function_id","in":"path","required":true,"schema":{"type":"string","title":"Function Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FunctionScheduleCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"# not yet implemented in python sdk","label":"python"}]},"delete":{"tags":["functions"],"summary":"Function Schedule Delete","operationId":"function_schedule_delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"function_id","in":"path","required":true,"schema":{"type":"string","title":"Function Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"# not yet implemented in python sdk","label":"python"}]}},"/functions/{function_id}/runs/start":{"post":{"tags":["functions"],"summary":"Function Run Start","operationId":"function_run_start","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"function_id","in":"path","required":true,"schema":{"type":"string","title":"Function Id"}},{"name":"x-notte-api-key","in":"header","required":true,"schema":{"type":"string","title":"X-Notte-Api-Key"}},{"name":"x-db-preview","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Db-Preview"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunFunctionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"from notte_sdk import NotteClient\n\nnotte = NotteClient()\n# retrieve the function\nfn = notte.Function(\"<function_id>\")\n# Run the function, providing variables\nresponse = fn.run(url=\"https://shop.notte.cc/\")\nprint(f\"Function completed with result: {response.result}\")","label":"python"},{"lang":"JavaScript","source":"import { NotteClient } from \"notte-sdk\";\n\nconst notte = new NotteClient();\nconst fn = notte.NotteFunction({\n  function_id: \"<function_id>\",\n});\nconst result = await fn.run({ url: \"https://shop.notte.cc/\" });\nconsole.log(\"Function run result:\", result);","label":"node"}]}},"/functions/{function_id}/runs/{run_id}":{"get":{"tags":["functions"],"summary":"Function Run Get Metadata","operationId":"function_run_get_metadata","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"function_id","in":"path","required":true,"schema":{"type":"string","title":"Function Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetFunctionRunResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true},"patch":{"tags":["functions"],"summary":"Function Run Update Metadata","operationId":"function_run_update_metadata","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"function_id","in":"path","required":true,"schema":{"type":"string","title":"Function Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FunctionRunUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateFunctionRunResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true},"delete":{"tags":["functions"],"summary":"Function Run Stop","operationId":"function_run_stop","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"function_id","in":"path","required":true,"schema":{"type":"string","title":"Function Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateFunctionRunResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/functions/{function_id}/runs":{"get":{"tags":["functions"],"summary":"List Function Runs By Function Id","operationId":"list_function_runs_by_function_id","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"function_id","in":"path","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Function Id"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of items per page","default":10,"title":"Page Size"},"description":"Number of items per page"},{"name":"only_active","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return active function runs","default":false,"title":"Only Active"},"description":"Whether to only return active function runs"},{"name":"only_current_token","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return function runs for the current token (apikey)","default":false,"title":"Only Current Token"},"description":"Whether to only return function runs for the current token (apikey)"},{"name":"include_system","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to include internal system function runs","default":true,"title":"Include System"},"description":"Whether to include internal system function runs"},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/FunctionSource"},{"type":"null"}],"description":"Only return runs of functions created from this source","title":"Source"},"description":"Only return runs of functions created from this source"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_FunctionRunListItemResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/vaults/create":{"post":{"tags":["vaults"],"summary":"Vault Create","operationId":"vault_create","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Vault"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"import os\n\nfrom notte_sdk import NotteClient\n\nnotte = NotteClient(server_url=os.environ[\"NOTTE_API_URL\"])\n# retrieve an existing vault or use console.notte.cc/vaults to create a new one\nvault = notte.Vault(\"<vault_id>\")","label":"python"},{"lang":"JavaScript","source":"import { NotteClient } from \"notte-sdk\";\n\nconst notte = new NotteClient();\n// retrieve an existing vault or use console.notte.cc/vaults to create a new one\nconst vault = notte.Vault({ vault_id: \"<vault_id>\" });","label":"node"},{"lang":"Curl","source":"curl -X POST \"https://api.notte.cc/vaults/create\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\" \\\n-d '{\n\"name\": \"default\"\n}'","label":"curl"}]}},"/vaults/{vault_id}/credentials":{"post":{"tags":["vaults"],"summary":"Vault Credentials Add","operationId":"vault_credentials_add","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"vault_id","in":"path","required":true,"schema":{"type":"string","title":"Vault Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddCredentialsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddCredentialsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true},"get":{"tags":["vaults"],"summary":"Vault Credentials Get","operationId":"vault_credentials_get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"vault_id","in":"path","required":true,"schema":{"type":"string","title":"Vault Id"}},{"name":"url","in":"query","required":true,"schema":{"type":"string","description":"URL upon which to get credentials","title":"Url"},"description":"URL upon which to get credentials"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCredentialsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"from notte_sdk import NotteClient\n\nnotte = NotteClient()\n# retrieve an existing vault\nvault = notte.Vault(\"<vault_id>\")\ncreds = vault.get_credentials(\n    url=\"https://www.google.com\"\n)\nif creds is None:\n    raise ValueError()\nprint(creds.get(\"email\"), creds[\"password\"])","label":"python"},{"lang":"JavaScript","source":"import { NotteClient } from \"notte-sdk\";\n\nconst notte = new NotteClient();\n// retrieve an existing vault\nconst vault = notte.Vault({ vault_id: \"<vault_id>\" });\nconst creds = await vault.getCredentials(\n  \"https://www.google.com\"\n);\nif (!creds) {\n  throw new Error(\"No credentials found\");\n}\nconsole.log(creds.email, creds.password);","label":"node"},{"lang":"Curl","source":"curl -X GET \"https://api.notte.cc/vaults/$vault_id\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\"","label":"curl"}]},"delete":{"tags":["vaults"],"summary":"Vault Credentials Delete","operationId":"vault_credentials_delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"vault_id","in":"path","required":true,"schema":{"type":"string","title":"Vault Id"}},{"name":"url","in":"query","required":true,"schema":{"type":"string","description":"URL upon which to get credentials","title":"Url"},"description":"URL upon which to get credentials"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteCredentialsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/vaults/{vault_id}":{"get":{"tags":["vaults"],"summary":"Vault Credentials List","operationId":"vault_credentials_list","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"vault_id","in":"path","required":true,"schema":{"type":"string","title":"Vault Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListCredentialsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true},"patch":{"tags":["vaults"],"summary":"Vault Update","operationId":"vault_update","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"vault_id","in":"path","required":true,"schema":{"type":"string","title":"Vault Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Vault"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true},"delete":{"tags":["vaults"],"summary":"Vault Delete","operationId":"vault_delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"vault_id","in":"path","required":true,"schema":{"type":"string","title":"Vault Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteVaultResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/vaults/{vault_id}/card":{"post":{"tags":["vaults"],"summary":"Vault Credit Card Set","operationId":"vault_credit_card_set","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"vault_id","in":"path","required":true,"schema":{"type":"string","title":"Vault Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddCreditCardRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddCreditCardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true},"get":{"tags":["vaults"],"summary":"Vault Credit Card Get","operationId":"vault_credit_card_get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"vault_id","in":"path","required":true,"schema":{"type":"string","title":"Vault Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCreditCardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true},"delete":{"tags":["vaults"],"summary":"Vault Credit Card Delete","operationId":"vault_credit_card_delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"vault_id","in":"path","required":true,"schema":{"type":"string","title":"Vault Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteCreditCardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/vaults":{"get":{"tags":["vaults"],"summary":"List Vaults","operationId":"list_vaults","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of items per page","default":10,"title":"Page Size"},"description":"Number of items per page"},{"name":"only_active","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return active sessions","default":true,"title":"Only Active"},"description":"Whether to only return active sessions"},{"name":"only_current_token","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return sessions for the current token (apikey)","default":false,"title":"Only Current Token"},"description":"Whether to only return sessions for the current token (apikey)"},{"name":"include_system","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to include internal system sessions","default":true,"title":"Include System"},"description":"Whether to include internal system sessions"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_Vault_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/profiles/create":{"post":{"tags":["profiles"],"summary":"Profile Create","operationId":"profile_create","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"from notte_sdk import NotteClient\n\nnotte = NotteClient()\n# Create a new browser profile with a name\nprofile = notte.profiles.create(name=\"my-profile\")\nprint(f\"Created profile: {profile.profile_id}\")\n# Cleanup\n_ = notte.profiles.delete(profile.profile_id)","label":"python"},{"lang":"Curl","source":"curl -X POST \"https://api.notte.cc/profiles/create\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\" \\\n-d '{\n\"name\": \"my-profile\"\n}'","label":"curl"}]}},"/profiles/{profile_id}":{"get":{"tags":["profiles"],"summary":"Profile Get","operationId":"profile_get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","title":"Profile Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"from notte_sdk import NotteClient\n\nnotte = NotteClient()\n# Create a profile first\nprofile = notte.profiles.create(name=\"test-profile\")\n# Get the profile by ID\nretrieved = notte.profiles.get(profile.profile_id)\nprint(f\"Profile: {retrieved.profile_id}, name: {retrieved.name}\")\n# Cleanup\n_ = notte.profiles.delete(profile.profile_id)","label":"python"},{"lang":"Curl","source":"curl -X GET \"https://api.notte.cc/profiles/$profile_id\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\"","label":"curl"}]},"delete":{"tags":["profiles"],"summary":"Profile Delete","operationId":"profile_delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","title":"Profile Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"from notte_sdk import NotteClient\n\nnotte = NotteClient()\n# Create a profile first\nprofile = notte.profiles.create(name=\"profile-to-delete\")\n# Delete the profile\ndeleted = notte.profiles.delete(profile.profile_id)\nprint(f\"Profile deleted: {deleted}\")","label":"python"},{"lang":"Curl","source":"curl -X DELETE \"https://api.notte.cc/profiles/$profile_id\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\"","label":"curl"}]}},"/profiles/{profile_id}/duplicate":{"post":{"tags":["profiles"],"summary":"Profile Duplicate","operationId":"profile_duplicate","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","title":"Profile Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileDuplicateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/profiles/{profile_id}/cookies":{"post":{"tags":["profiles"],"summary":"Profile Cookies Set","operationId":"profile_cookies_set","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","title":"Profile Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileCookiesImportRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileCookiesImportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]},"get":{"tags":["profiles"],"summary":"Profile Cookies Get","operationId":"profile_cookies_get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","title":"Profile Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCookiesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/profiles":{"get":{"tags":["profiles"],"summary":"Profile List","operationId":"profile_list","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of items per page","default":10,"title":"Page Size"},"description":"Number of items per page"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter profiles by name","title":"Name"},"description":"Filter profiles by name"},{"name":"only_active","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return active profiles","default":true,"title":"Only Active"},"description":"Whether to only return active profiles"},{"name":"only_current_token","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return profiles for the current token (apikey)","default":false,"title":"Only Current Token"},"description":"Whether to only return profiles for the current token (apikey)"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_ProfileResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"from notte_sdk import NotteClient\n\nnotte = NotteClient()\n# List all profiles with pagination\nprofiles = notte.profiles.list(page=1, page_size=10)\nfor profile in profiles:\n    print(f\"Profile: {profile.profile_id}, name: {profile.name}\")","label":"python"},{"lang":"Curl","source":"curl -X GET \"https://api.notte.cc/profiles?page=1&page_size=10\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\"","label":"curl"}]}},"/personas/create":{"post":{"tags":["personas"],"summary":"Persona Create","operationId":"persona_create","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonaCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/personas/{persona_id}":{"delete":{"tags":["personas"],"summary":"Persona Delete","operationId":"persona_delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"persona_id","in":"path","required":true,"schema":{"type":"string","title":"Persona Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletePersonaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true},"get":{"tags":["personas"],"summary":"Persona Get","operationId":"persona_get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"persona_id","in":"path","required":true,"schema":{"type":"string","title":"Persona Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"from notte_sdk.client import NotteClient\n\nnotte = NotteClient()\n# retrieve an existing persona or use console.notte.cc/personas to create a new one\npersona = notte.Persona(\"<my-persona-id>\")\nprint(\n    f\"{persona.info.email=} {persona.info.phone_number=}\"\n)","label":"python"},{"lang":"JavaScript","source":"import { NotteClient } from \"notte-sdk\";\n\nconst notte = new NotteClient();\n// retrieve an existing persona or use console.notte.cc/personas to create a new one\nconst persona = notte.Persona({ persona_id: \"<my-persona-id>\" });\nconst info = await persona.get();\nconsole.log(`email=${info.email} phone_number=${info.phone_number}`);","label":"node"},{"lang":"Curl","source":"curl -X GET \"https://api.notte.cc/personas/$persona_id\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\"","label":"curl"}]},"patch":{"tags":["personas"],"summary":"Persona Update","operationId":"persona_update","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"persona_id","in":"path","required":true,"schema":{"type":"string","title":"Persona Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonaUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/personas/{persona_id}/emails":{"get":{"tags":["personas"],"summary":"Persona Emails List","operationId":"persona_emails_list","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"persona_id","in":"path","required":true,"schema":{"type":"string","title":"Persona Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum number of emails","default":10,"title":"Limit"},"description":"Maximum number of emails"},{"name":"timedelta","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"duration"},{"type":"null"}],"description":"Maximum time since email reception","title":"Timedelta"},"description":"Maximum time since email reception"},{"name":"only_unread","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return unread messages","default":false,"title":"Only Unread"},"description":"Whether to only return unread messages"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/EmailResponse"},"title":"Response Persona Emails List Personas  Persona Id  Emails Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"import datetime as dt\n\nfrom notte_sdk.client import NotteClient\n\nnotte = NotteClient()\n# retrieve an existing persona or use console.notte.cc/personas to create a new one\npersona = notte.Persona(\"<my-persona-id>\")\n# read recent emails (received in the past 5 minutes)\nrecent_emails = persona.emails(\n    only_unread=True,\n    limit=10,\n    timedelta=dt.timedelta(minutes=5),\n)\nprint(f\"Recent emails: {recent_emails}\")","label":"python"},{"lang":"JavaScript","source":"import { NotteClient } from \"notte-sdk\";\n\nconst notte = new NotteClient();\n// retrieve an existing persona or use console.notte.cc/personas to create a new one\nconst persona = notte.Persona({ persona_id: \"<my-persona-id>\" });\n// read recent emails (received in the past 5 minutes)\nconst recentEmails = await persona.emails({\n  only_unread: true,\n  limit: 10,\n  timedelta: \"5m\",\n});\nconsole.log(\"Recent emails:\", recentEmails);","label":"node"},{"lang":"Curl","source":"curl -X GET \"https://api.notte.cc/personas/$persona_id/emails?limit=10&only_unread=true\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\"","label":"curl"}]}},"/personas":{"get":{"tags":["personas"],"summary":"List Personas","operationId":"list_personas","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of items per page","default":10,"title":"Page Size"},"description":"Number of items per page"},{"name":"only_active","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return active sessions","default":true,"title":"Only Active"},"description":"Whether to only return active sessions"},{"name":"only_current_token","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return sessions for the current token (apikey)","default":false,"title":"Only Current Token"},"description":"Whether to only return sessions for the current token (apikey)"},{"name":"include_system","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to include internal system sessions","default":true,"title":"Include System"},"description":"Whether to include internal system sessions"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_PersonaResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/personas/{persona_id}/sms":{"get":{"tags":["personas"],"summary":"Persona Sms List","operationId":"persona_sms_list","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"persona_id","in":"path","required":true,"schema":{"type":"string","title":"Persona Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum number of emails","default":10,"title":"Limit"},"description":"Maximum number of emails"},{"name":"timedelta","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"duration"},{"type":"null"}],"description":"Maximum time since email reception","title":"Timedelta"},"description":"Maximum time since email reception"},{"name":"only_unread","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return unread messages","default":false,"title":"Only Unread"},"description":"Whether to only return unread messages"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SMSResponse"},"title":"Response Persona Sms List Personas  Persona Id  Sms Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"import datetime as dt\n\nfrom notte_sdk.client import NotteClient\n\nnotte = NotteClient()\n# retrieve an existing persona or use console.notte.cc/personas to create a new one\npersona = notte.Persona(\"<my-persona-id>\")\n# read recent sms (received in the past 5 minutes)\nrecent_sms = persona.sms(\n    only_unread=True,\n    limit=10,\n    timedelta=dt.timedelta(minutes=5),\n)\nprint(f\"Recent sms: {recent_sms}\")","label":"python"},{"lang":"JavaScript","source":"import { NotteClient } from \"notte-sdk\";\n\nconst notte = new NotteClient();\n// retrieve an existing persona or use console.notte.cc/personas to create a new one\nconst persona = notte.Persona({ persona_id: \"<my-persona-id>\" });\n// read recent sms (received in the past 5 minutes)\nconst recentSms = await persona.sms({\n  only_unread: true,\n  limit: 10,\n  timedelta: \"5m\",\n});\nconsole.log(\"Recent sms:\", recentSms);","label":"node"},{"lang":"Curl","source":"curl -X GET \"https://api.notte.cc/personas/$persona_id/sms?limit=10&only_unread=true\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\"","label":"curl"}]}},"/mailboxes/connect-token":{"post":{"tags":["mailboxes"],"summary":"Mailbox Connect Token","operationId":"mailbox_connect_token","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MailboxConnectRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MailboxConnectResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/mailboxes/sync":{"post":{"tags":["mailboxes"],"summary":"Mailbox Sync","operationId":"mailbox_sync","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/MailboxSyncRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MailboxListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/mailboxes":{"get":{"tags":["mailboxes"],"summary":"Mailbox List","operationId":"mailbox_list","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MailboxListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/mailboxes/{mailbox_id}":{"get":{"tags":["mailboxes"],"summary":"Mailbox Get","operationId":"mailbox_get","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"mailbox_id","in":"path","required":true,"schema":{"type":"string","title":"Mailbox Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MailboxConnection"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]},"patch":{"tags":["mailboxes"],"summary":"Mailbox Update","operationId":"mailbox_update","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"mailbox_id","in":"path","required":true,"schema":{"type":"string","title":"Mailbox Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MailboxUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MailboxConnection"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]},"delete":{"tags":["mailboxes"],"summary":"Mailbox Delete","operationId":"mailbox_delete","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"mailbox_id","in":"path","required":true,"schema":{"type":"string","title":"Mailbox Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/managed-auth/connect-links":{"post":{"tags":["managed-auth"],"summary":"Managed Auth Connect Link Create","operationId":"managed_auth_connect_link_create","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectLinkCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectLinkCreateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Curl","source":"curl -X POST \"https://api.notte.cc/managed-auth/connect-links\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\" \\\n-d '{\n\"template_id\": \"template_id\",\n\"label\": \"Acme user Airbnb account\",\n\"external_user_id\": \"your-user-42\",\n\"success_redirect_uri\": \"https://acme.example.com/settings?connected=1\",\n\"error_redirect_uri\": \"https://acme.example.com/settings?connected=0\",\n\"webhook_url\": \"https://acme.example.com/hooks/notte\",\n\"ttl_seconds\": 900\n}'","label":"curl"}]}},"/managed-auth/connect-links/context":{"post":{"tags":["managed-auth"],"summary":" Connect Link Context","operationId":"_connect_link_context","parameters":[{"name":"X-Notte-Connect-Token","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"description":"The connect token from the link URL.","title":"X-Notte-Connect-Token"},"description":"The connect token from the link URL."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectLinkContext"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/managed-auth/connect-links/mailboxes":{"post":{"tags":["managed-auth"],"summary":" Connect Link Mailboxes","operationId":"_connect_link_mailboxes","parameters":[{"name":"X-Notte-Connect-Token","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"description":"The connect token from the link URL.","title":"X-Notte-Connect-Token"},"description":"The connect token from the link URL."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ConnectLinkMailbox"},"title":"Response  Connect Link Mailboxes Managed Auth Connect Links Mailboxes Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/managed-auth/connect-links/mailboxes/connect":{"post":{"tags":["managed-auth"],"summary":" Connect Link Mailbox Connect","operationId":"_connect_link_mailbox_connect","parameters":[{"name":"X-Notte-Connect-Token","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"description":"The connect token from the link URL.","title":"X-Notte-Connect-Token"},"description":"The connect token from the link URL."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectLinkMailboxConnectRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectLinkMailboxConnectResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/managed-auth/connect-links/mailboxes/sync":{"post":{"tags":["managed-auth"],"summary":" Connect Link Mailbox Sync","operationId":"_connect_link_mailbox_sync","parameters":[{"name":"X-Notte-Connect-Token","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"description":"The connect token from the link URL.","title":"X-Notte-Connect-Token"},"description":"The connect token from the link URL."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectLinkMailboxSyncRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ConnectLinkMailbox"},"title":"Response  Connect Link Mailbox Sync Managed Auth Connect Links Mailboxes Sync Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/managed-auth/connect-links/submit":{"post":{"tags":["managed-auth"],"summary":" Connect Link Submit","operationId":"_connect_link_submit","parameters":[{"name":"X-Notte-Connect-Token","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"description":"The connect token from the link URL.","title":"X-Notte-Connect-Token"},"description":"The connect token from the link URL."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectLinkSubmitRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectLinkStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/managed-auth/connect-links/status":{"get":{"tags":["managed-auth"],"summary":" Connect Link Status","operationId":"_connect_link_status","parameters":[{"name":"X-Notte-Connect-Token","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"description":"The connect token from the link URL.","title":"X-Notte-Connect-Token"},"description":"The connect token from the link URL."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectLinkStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/prompts/improve":{"post":{"tags":["prompts"],"summary":"Improve Prompt","operationId":"improve_prompt","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImprovePromptRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImprovePromptResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/prompts/nudge":{"post":{"tags":["prompts"],"summary":"Nudge Prompt","operationId":"nudge_prompt","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NudgePromptRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NudgePromptResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/usage":{"get":{"tags":["usage"],"summary":"Get Usage","operationId":"get_usage","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"period","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The montly period to get usage for, i.e May 2025","title":"Period"},"description":"The montly period to get usage for, i.e May 2025"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/usage/logs":{"get":{"tags":["usage"],"summary":"Get Usage Logs","operationId":"get_usage_logs","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"endpoint","in":"query","required":false,"schema":{"anyOf":[{"enum":["sessions.start","sessions.stop","sessions.status","sessions.cookies.set","sessions.cookies.get","sessions.list","sessions.replay","sessions.offset","sessions.debug.info","sessions.debug.info.tab","sessions.debug.recording.wss","sessions.debug.log.wss","sessions.debug.tab.wss","sessions.debug.browser.wss","sessions.network.logs","sessions.script","page.observe","page.execute","page.scrape","profiles.create","profiles.duplicate","profiles.get","profiles.list","profiles.delete","profiles.cookies.set","profiles.cookies.get","vaults.create","vaults.list","vaults.delete","vaults.update","vaults.credentials.add","vaults.credentials.get","vaults.credentials.delete","vaults.credentials.list","vaults.credit_card.set","vaults.credit_card.get","vaults.credit_card.delete","personas.create","personas.list","personas.delete","personas.emails","personas.sms","personas.number.create","personas.get","personas.update","mailboxes.connect","mailboxes.sync","mailboxes.list","mailboxes.get","mailboxes.update","mailboxes.delete","sessions.files.upload","sessions.files.list","sessions.files.download","sessions.files.delete","agents.start","agents.stop","agents.status","agents.list","agents.replay","agents.debug.recording","agents.save","agents.repeat","agents.script","bua","scrape","scrape_from_html","search","usage","workflows.upload","workflows.download","workflows.list","workflows.delete","workflows.update","workflows.fork","workflows.rollback","workflows.schedule.create","workflows.schedule.delete","workflows.runs.create","workflows.runs.start","workflows.runs.get","workflows.runs.list","workflows.runs.update","workflows.runs.stop"],"type":"string"},{"type":"null"}],"description":"The endpoint to filter logs by","title":"Endpoint"},"description":"The endpoint to filter logs by"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of items per page","default":10,"title":"Page Size"},"description":"Number of items per page"},{"name":"only_active","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return active sessions","default":true,"title":"Only Active"},"description":"Whether to only return active sessions"},{"name":"only_current_token","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to only return sessions for the current token (apikey)","default":false,"title":"Only Current Token"},"description":"Whether to only return sessions for the current token (apikey)"},{"name":"include_system","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to include internal system sessions","default":true,"title":"Include System"},"description":"Whether to include internal system sessions"},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_UsageLog_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}},"/anything/start":{"post":{"tags":["anything"],"summary":"Anything Start","operationId":"anything_start","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnythingStartRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/secrets":{"post":{"tags":["secrets"],"summary":"Store Secret","operationId":"store_secret","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecretStoreRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecretMetadata"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]},"get":{"tags":["secrets"],"summary":"List Secrets","operationId":"list_secrets","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"namespace","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SecretNamespace"},{"type":"null"}],"title":"Namespace"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecretListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/secrets/{name}":{"get":{"tags":["secrets"],"summary":"Get Secret","operationId":"get_secret","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}},{"name":"namespace","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SecretNamespace"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecretValueResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/secrets/{secret_id}":{"delete":{"tags":["secrets"],"summary":"Delete Secret","operationId":"delete_secret","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"secret_id","in":"path","required":true,"schema":{"type":"string","title":"Secret Id"}},{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/health":{"get":{"tags":["health"],"summary":"Health Check","operationId":"health_check","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}},"x-hidden":true}},"/ready":{"get":{"tags":["health"],"summary":"Ready Check","operationId":"ready_check","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}},"x-hidden":true}},"/scrape":{"post":{"tags":["scrape"],"summary":"Scrape Webpage","operationId":"scrape_webpage","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GlobalScrapeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSpace"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Python","source":"from notte_sdk import NotteClient\nfrom pydantic import BaseModel\n\n\nclass CompanyInfo(BaseModel):\n    name: str\n    foundation_year: int\n    location: str\n\n\nnotte = NotteClient()\ncompany_info = notte.scrape(\n    url=\"https://www.ycombinator.com/companies/nottelabs\",\n    instructions=\"Extract the company info from the webpage\",\n    response_format=CompanyInfo,\n    only_main_content=False,\n)","label":"python"},{"lang":"JavaScript","source":"import { NotteClient } from \"notte-sdk\";\nimport { z } from \"zod\";\n\nconst CompanyInfo = z.object({\n  name: z.string(),\n  foundation_year: z.number(),\n  location: z.string(),\n});\n\nconst notte = new NotteClient();\nconst companyInfo = await notte.scrape(\n  \"https://www.ycombinator.com/companies/nottelabs\",\n  {\n    instructions: \"Extract the company info from the webpage\",\n    response_format: CompanyInfo,\n    only_main_content: false,\n  }\n);","label":"node"},{"lang":"Curl","source":"curl -X POST \"https://api.notte.cc/scrape\" \\\n-H \"Authorization: Bearer $NOTTE_API_KEY\" \\\n-H \"Content-Type: application/json\" \\\n-d '{\n\"headless\": true,\n\"solve_captchas\": false,\n\"timeout_minutes\": 3,\n\"proxies\": false,\n\"browser_type\": \"chromium\",\n\"user_agent\": null,\n\"chrome_args\": null,\n\"viewport_width\": null,\n\"viewport_height\": null,\n\"cdp_url\": null,\n\"screenshot_type\": \"last_action\",\n\"scrape_links\": true,\n\"scrape_images\": false,\n\"ignored_tags\": null,\n\"only_main_content\": true,\n\"only_images\": false,\n\"response_format\": null,\n\"instructions\": null,\n\"use_link_placeholders\": false,\n\"url\": \"www.google.com\"\n}'","label":"curl"}]}},"/search":{"post":{"tags":["search"],"summary":"Search Web","operationId":"search_web","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[]}},"/scrape_from_html":{"post":{"tags":["scrape"],"summary":"Scrape From Html","operationId":"scrape_from_html","security":[{"OAuth2PasswordBearer":[]}],"parameters":[{"name":"x-notte-request-origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Request-Origin"}},{"name":"x-notte-sdk-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Notte-Sdk-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScrapeFromHtmlRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScrapeSchemaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-hidden":true}}},"components":{"schemas":{"ActionParameter":{"properties":{"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type"},"default":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default"},"values":{"items":{"type":"string"},"type":"array","title":"Values"}},"type":"object","required":["name","type"],"title":"ActionParameter"},"ActionSpace":{"properties":{"description":{"type":"string","title":"Description","description":"Human-readable description of the current web page"},"interaction_actions":{"items":{"oneOf":[{"$ref":"#/components/schemas/ClickAction-Output"},{"$ref":"#/components/schemas/FillAction-Output"},{"$ref":"#/components/schemas/MultiFactorFillAction-Output"},{"$ref":"#/components/schemas/FallbackFillAction-Output"},{"$ref":"#/components/schemas/CheckAction-Output"},{"$ref":"#/components/schemas/SelectDropdownOptionAction-Output"},{"$ref":"#/components/schemas/UploadFileAction-Output"},{"$ref":"#/components/schemas/DownloadFileAction-Output"}],"discriminator":{"propertyName":"type","mapping":{"check":"#/components/schemas/CheckAction-Output","click":"#/components/schemas/ClickAction-Output","download_file":"#/components/schemas/DownloadFileAction-Output","fallback_fill":"#/components/schemas/FallbackFillAction-Output","fill":"#/components/schemas/FillAction-Output","multi_factor_fill":"#/components/schemas/MultiFactorFillAction-Output","select_dropdown_option":"#/components/schemas/SelectDropdownOptionAction-Output","upload_file":"#/components/schemas/UploadFileAction-Output"}}},"type":"array","title":"Interaction Actions","description":"List of available interaction actions in the current state"},"category":{"anyOf":[{"$ref":"#/components/schemas/SpaceCategory"},{"type":"null"}],"description":"Category of the action space (e.g., 'homepage', 'search-results', 'item')"},"actions":{"items":{"oneOf":[{"$ref":"#/components/schemas/FormFillAction"},{"$ref":"#/components/schemas/GotoAction"},{"$ref":"#/components/schemas/GotoNewTabAction"},{"$ref":"#/components/schemas/CloseTabAction"},{"$ref":"#/components/schemas/SwitchTabAction"},{"$ref":"#/components/schemas/GoBackAction"},{"$ref":"#/components/schemas/GoForwardAction"},{"$ref":"#/components/schemas/ReloadAction"},{"$ref":"#/components/schemas/WaitAction"},{"$ref":"#/components/schemas/PressKeyAction"},{"$ref":"#/components/schemas/ScrollUpAction"},{"$ref":"#/components/schemas/ScrollDownAction"},{"$ref":"#/components/schemas/CaptchaSolveAction"},{"$ref":"#/components/schemas/HelpAction"},{"$ref":"#/components/schemas/CompletionAction"},{"$ref":"#/components/schemas/ScrapeAction"},{"$ref":"#/components/schemas/EmailReadAction"},{"$ref":"#/components/schemas/EmailVerificationReadAction"},{"$ref":"#/components/schemas/SmsReadAction"},{"$ref":"#/components/schemas/EvaluateJsAction"},{"$ref":"#/components/schemas/ClickAction-Output"},{"$ref":"#/components/schemas/FillAction-Output"},{"$ref":"#/components/schemas/MultiFactorFillAction-Output"},{"$ref":"#/components/schemas/FallbackFillAction-Output"},{"$ref":"#/components/schemas/CheckAction-Output"},{"$ref":"#/components/schemas/SelectDropdownOptionAction-Output"},{"$ref":"#/components/schemas/UploadFileAction-Output"},{"$ref":"#/components/schemas/DownloadFileAction-Output"}],"discriminator":{"propertyName":"type","mapping":{"captcha_solve":"#/components/schemas/CaptchaSolveAction","check":"#/components/schemas/CheckAction-Output","click":"#/components/schemas/ClickAction-Output","close_tab":"#/components/schemas/CloseTabAction","completion":"#/components/schemas/CompletionAction","download_file":"#/components/schemas/DownloadFileAction-Output","email_read":"#/components/schemas/EmailReadAction","email_verification_read":"#/components/schemas/EmailVerificationReadAction","evaluate_js":"#/components/schemas/EvaluateJsAction","fallback_fill":"#/components/schemas/FallbackFillAction-Output","fill":"#/components/schemas/FillAction-Output","form_fill":"#/components/schemas/FormFillAction","go_back":"#/components/schemas/GoBackAction","go_forward":"#/components/schemas/GoForwardAction","goto":"#/components/schemas/GotoAction","goto_new_tab":"#/components/schemas/GotoNewTabAction","help":"#/components/schemas/HelpAction","multi_factor_fill":"#/components/schemas/MultiFactorFillAction-Output","press_key":"#/components/schemas/PressKeyAction","reload":"#/components/schemas/ReloadAction","scrape":"#/components/schemas/ScrapeAction","scroll_down":"#/components/schemas/ScrollDownAction","scroll_up":"#/components/schemas/ScrollUpAction","select_dropdown_option":"#/components/schemas/SelectDropdownOptionAction-Output","sms_read":"#/components/schemas/SmsReadAction","switch_tab":"#/components/schemas/SwitchTabAction","upload_file":"#/components/schemas/UploadFileAction-Output","wait":"#/components/schemas/WaitAction"}}},"type":"array","title":"Actions","readOnly":true},"browser_actions":{"items":{"oneOf":[{"$ref":"#/components/schemas/FormFillAction"},{"$ref":"#/components/schemas/GotoAction"},{"$ref":"#/components/schemas/GotoNewTabAction"},{"$ref":"#/components/schemas/CloseTabAction"},{"$ref":"#/components/schemas/SwitchTabAction"},{"$ref":"#/components/schemas/GoBackAction"},{"$ref":"#/components/schemas/GoForwardAction"},{"$ref":"#/components/schemas/ReloadAction"},{"$ref":"#/components/schemas/WaitAction"},{"$ref":"#/components/schemas/PressKeyAction"},{"$ref":"#/components/schemas/ScrollUpAction"},{"$ref":"#/components/schemas/ScrollDownAction"},{"$ref":"#/components/schemas/CaptchaSolveAction"},{"$ref":"#/components/schemas/HelpAction"},{"$ref":"#/components/schemas/CompletionAction"},{"$ref":"#/components/schemas/ScrapeAction"},{"$ref":"#/components/schemas/EmailReadAction"},{"$ref":"#/components/schemas/EmailVerificationReadAction"},{"$ref":"#/components/schemas/SmsReadAction"},{"$ref":"#/components/schemas/EvaluateJsAction"}],"discriminator":{"propertyName":"type","mapping":{"captcha_solve":"#/components/schemas/CaptchaSolveAction","close_tab":"#/components/schemas/CloseTabAction","completion":"#/components/schemas/CompletionAction","email_read":"#/components/schemas/EmailReadAction","email_verification_read":"#/components/schemas/EmailVerificationReadAction","evaluate_js":"#/components/schemas/EvaluateJsAction","form_fill":"#/components/schemas/FormFillAction","go_back":"#/components/schemas/GoBackAction","go_forward":"#/components/schemas/GoForwardAction","goto":"#/components/schemas/GotoAction","goto_new_tab":"#/components/schemas/GotoNewTabAction","help":"#/components/schemas/HelpAction","press_key":"#/components/schemas/PressKeyAction","reload":"#/components/schemas/ReloadAction","scrape":"#/components/schemas/ScrapeAction","scroll_down":"#/components/schemas/ScrollDownAction","scroll_up":"#/components/schemas/ScrollUpAction","sms_read":"#/components/schemas/SmsReadAction","switch_tab":"#/components/schemas/SwitchTabAction","wait":"#/components/schemas/WaitAction"}}},"type":"array","title":"Browser Actions","readOnly":true},"markdown":{"type":"string","title":"Markdown","readOnly":true}},"type":"object","required":["description","interaction_actions","actions","browser_actions","markdown"],"title":"ActionSpace"},"AddCredentialsRequest":{"properties":{"url":{"type":"string","title":"Url"},"credentials":{"$ref":"#/components/schemas/CredentialsDict-Input","description":"Credentials to add"}},"additionalProperties":false,"type":"object","required":["url","credentials"],"title":"AddCredentialsRequest"},"AddCredentialsResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Status of the created credentials"}},"type":"object","required":["status"],"title":"AddCredentialsResponse"},"AddCreditCardRequest":{"properties":{"credit_card":{"$ref":"#/components/schemas/CreditCardDict-Input","description":"Credit card to add"}},"additionalProperties":false,"type":"object","required":["credit_card"],"title":"AddCreditCardRequest"},"AddCreditCardResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Status of the created credit card"}},"type":"object","required":["status"],"title":"AddCreditCardResponse"},"AgentFunctionCodeResponse":{"properties":{"python_script":{"type":"string","title":"Python Script","description":"Python script to replicate agent steps"},"json_actions":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Json Actions","description":"Json actions to replicate agent steps"}},"type":"object","required":["python_script","json_actions"],"title":"AgentFunctionCodeResponse"},"AgentResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id","description":"The ID of the agent"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"The creation time of the agent"},"session_id":{"type":"string","title":"Session Id","description":"The ID of the session"},"status":{"$ref":"#/components/schemas/AgentStatus","description":"The status of the agent (active or closed)"},"closed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Closed At","description":"The closing time of the agent"},"saved":{"type":"boolean","title":"Saved","description":"Whether the agent is saved as a workflow","default":false}},"type":"object","required":["agent_id","created_at","session_id","status"],"title":"AgentResponse"},"AgentStatus":{"type":"string","enum":["active","closed"],"title":"AgentStatus"},"AgentStatusResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id","description":"The ID of the agent"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"The creation time of the agent"},"session_id":{"type":"string","title":"Session Id","description":"The ID of the session"},"status":{"$ref":"#/components/schemas/AgentStatus","description":"The status of the agent (active or closed)"},"closed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Closed At","description":"The closing time of the agent"},"saved":{"type":"boolean","title":"Saved","description":"Whether the agent is saved as a workflow","default":false},"task":{"type":"string","title":"Task","description":"The task that the agent is currently running"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"The URL that the agent started on"},"success":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Success","description":"Whether the agent task was successful. None if the agent is still running"},"answer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Answer","description":"The answer to the agent task. None if the agent is still running"},"steps":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Steps","description":"The steps that the agent has currently taken"}},"type":"object","required":["agent_id","created_at","session_id","status","task"],"title":"AgentStatusResponse"},"AnythingStartRequest":{"properties":{"task":{"type":"string","title":"Task"}},"type":"object","required":["task"],"title":"AnythingStartRequest"},"ApiAgentStartRequest":{"properties":{"task":{"type":"string","title":"Task","description":"The task that the agent should perform"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"The URL that the agent should start on (optional)"},"response_format":{"anyOf":[{},{"type":"null"}],"title":"Response Format","description":"The response format to use for the agent answer. You can use a Pydantic model or a JSON Schema dict (cf. https://docs.pydantic.dev/latest/concepts/json_schema/#generating-json-schema.)"},"session_offset":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Session Offset","description":"[Experimental] The step from which the agent should gather information from in the session. If none, fresh memory"},"reasoning_model":{"anyOf":[{"$ref":"#/components/schemas/LlmModel"},{"type":"string"}],"title":"Reasoning Model","description":"The reasoning model to use"},"use_vision":{"type":"boolean","title":"Use Vision","description":"Whether to use vision for the agent. Not all reasoning models support vision.","default":true},"max_steps":{"type":"integer","maximum":150.0,"minimum":1.0,"title":"Max Steps","description":"The maximum number of steps the agent should take","default":20},"vault_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vault Id","description":"The vault to use for the agent"},"persona_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona Id","description":"The persona to use for the agent"},"notifier_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Notifier Config","description":"Config used for the notifier"},"session_id":{"type":"string","title":"Session Id","description":"The ID of the session to run the agent on"}},"additionalProperties":false,"type":"object","required":["task","session_id"],"title":"ApiAgentStartRequest"},"ApiExecutionResponse":{"properties":{"started_at":{"type":"string","format":"date-time","title":"Started At"},"ended_at":{"type":"string","format":"date-time","title":"Ended At"},"action":{"oneOf":[{"$ref":"#/components/schemas/FormFillAction"},{"$ref":"#/components/schemas/GotoAction"},{"$ref":"#/components/schemas/GotoNewTabAction"},{"$ref":"#/components/schemas/CloseTabAction"},{"$ref":"#/components/schemas/SwitchTabAction"},{"$ref":"#/components/schemas/GoBackAction"},{"$ref":"#/components/schemas/GoForwardAction"},{"$ref":"#/components/schemas/ReloadAction"},{"$ref":"#/components/schemas/WaitAction"},{"$ref":"#/components/schemas/PressKeyAction"},{"$ref":"#/components/schemas/ScrollUpAction"},{"$ref":"#/components/schemas/ScrollDownAction"},{"$ref":"#/components/schemas/CaptchaSolveAction"},{"$ref":"#/components/schemas/HelpAction"},{"$ref":"#/components/schemas/CompletionAction"},{"$ref":"#/components/schemas/ScrapeAction"},{"$ref":"#/components/schemas/EmailReadAction"},{"$ref":"#/components/schemas/EmailVerificationReadAction"},{"$ref":"#/components/schemas/SmsReadAction"},{"$ref":"#/components/schemas/EvaluateJsAction"},{"$ref":"#/components/schemas/ClickAction-Output"},{"$ref":"#/components/schemas/FillAction-Output"},{"$ref":"#/components/schemas/MultiFactorFillAction-Output"},{"$ref":"#/components/schemas/FallbackFillAction-Output"},{"$ref":"#/components/schemas/CheckAction-Output"},{"$ref":"#/components/schemas/SelectDropdownOptionAction-Output"},{"$ref":"#/components/schemas/UploadFileAction-Output"},{"$ref":"#/components/schemas/DownloadFileAction-Output"}],"title":"Action","discriminator":{"propertyName":"type","mapping":{"captcha_solve":"#/components/schemas/CaptchaSolveAction","check":"#/components/schemas/CheckAction-Output","click":"#/components/schemas/ClickAction-Output","close_tab":"#/components/schemas/CloseTabAction","completion":"#/components/schemas/CompletionAction","download_file":"#/components/schemas/DownloadFileAction-Output","email_read":"#/components/schemas/EmailReadAction","email_verification_read":"#/components/schemas/EmailVerificationReadAction","evaluate_js":"#/components/schemas/EvaluateJsAction","fallback_fill":"#/components/schemas/FallbackFillAction-Output","fill":"#/components/schemas/FillAction-Output","form_fill":"#/components/schemas/FormFillAction","go_back":"#/components/schemas/GoBackAction","go_forward":"#/components/schemas/GoForwardAction","goto":"#/components/schemas/GotoAction","goto_new_tab":"#/components/schemas/GotoNewTabAction","help":"#/components/schemas/HelpAction","multi_factor_fill":"#/components/schemas/MultiFactorFillAction-Output","press_key":"#/components/schemas/PressKeyAction","reload":"#/components/schemas/ReloadAction","scrape":"#/components/schemas/ScrapeAction","scroll_down":"#/components/schemas/ScrollDownAction","scroll_up":"#/components/schemas/ScrollUpAction","select_dropdown_option":"#/components/schemas/SelectDropdownOptionAction-Output","sms_read":"#/components/schemas/SmsReadAction","switch_tab":"#/components/schemas/SwitchTabAction","upload_file":"#/components/schemas/UploadFileAction-Output","wait":"#/components/schemas/WaitAction"}}},"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"anyOf":[{"$ref":"#/components/schemas/DataSpace"},{"type":"null"}]},"exception":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Exception"},"exception_detail":{"anyOf":[{"$ref":"#/components/schemas/SerializedError"},{"type":"null"}]}},"type":"object","required":["started_at","ended_at","action","success","message"],"title":"ApiExecutionResponse"},"ApiSessionStartRequest":{"properties":{"solve_captchas":{"type":"boolean","title":"Solve Captchas","description":"Whether to try to automatically solve captchas","default":true},"max_duration_minutes":{"type":"integer","maximum":1440.0,"exclusiveMinimum":0.0,"title":"Max Duration Minutes","description":"Maximum session lifetime in minutes (absolute maximum, not affected by activity).","default":15},"idle_timeout_minutes":{"type":"integer","maximum":30.0,"exclusiveMinimum":0.0,"title":"Idle Timeout Minutes","description":"Idle timeout in minutes. Session closes after this period of inactivity (resets on each operation).","default":3},"proxies":{"anyOf":[{"items":{"oneOf":[{"$ref":"#/components/schemas/NotteProxy"},{"$ref":"#/components/schemas/ExternalProxy"},{"$ref":"#/components/schemas/TailnetProxy"}],"discriminator":{"propertyName":"type","mapping":{"external":"#/components/schemas/ExternalProxy","notte":"#/components/schemas/NotteProxy","tailnet":"#/components/schemas/TailnetProxy"}}},"type":"array"},{"type":"boolean"}],"title":"Proxies","description":"List of custom proxies to use for the session. If True, the default proxies will be used.","default":true},"browser_type":{"type":"string","enum":["chromium","chrome","chrome-nightly","chrome-turbo"],"title":"Browser Type","description":"The browser type to use. Supported values are chromium and chrome. chrome-nightly and chrome-turbo are legacy aliases for chrome.","default":"chromium"},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent","description":"The user agent to use for the session"},"chrome_args":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Chrome Args","description":"Overwrite the chrome instance arguments"},"viewport_width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Viewport Width","description":"The width of the viewport"},"viewport_height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Viewport Height","description":"The height of the viewport"},"aspect_ratio":{"anyOf":[{"type":"string","enum":["5:4","16:9"]},{"type":"null"}],"title":"Aspect Ratio","description":"Viewport shape preset. When set, the backend fits the largest rectangle of this aspect ratio inside the sampled available screen area. Cannot be combined with explicit viewport_width/viewport_height."},"cdp_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cdp Url","description":"The CDP URL of another remote session provider."},"screenshot_type":{"type":"string","enum":["raw","full","last_action"],"title":"Screenshot Type","description":"The type of screenshot to use for the session.","default":"last_action"},"profile":{"anyOf":[{"$ref":"#/components/schemas/SessionProfile"},{"type":"null"}],"description":"Browser profile configuration for state persistence"},"web_bot_auth":{"type":"boolean","title":"Web Bot Auth","description":"Whether to use web bot authentication.","default":false},"extra_http_headers":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Extra Http Headers","description":"Extra HTTP headers to be sent with every request."},"vault_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vault Id","description":"The vault to use for the session"},"auth_ids":{"items":{"type":"string"},"type":"array","maxItems":10,"title":"Auth Ids","description":"Managed Auth connection IDs to verify and, when necessary, authenticate inside this session. Authentication finishes before the session is returned unless wait_for_authentication is false."},"wait_for_authentication":{"type":"boolean","title":"Wait For Authentication","description":"Whether to wait for Managed Auth profile restoration and authentication before returning the session. When false, authentication continues in the background after the browser is ready.","default":true},"advanced_stealth":{"type":"boolean","title":"Advanced Stealth","description":"Enable Notte's highest-fidelity browser environment for sites with sophisticated bot detection. Available to approved workspaces.","default":false},"demonstrate":{"type":"boolean","title":"Demonstrate","description":"Whether to enable the Notte recorder extension for this session. The extension is installed but remains inactive when this is false.","default":false}},"additionalProperties":false,"type":"object","title":"ApiSessionStartRequest"},"BaseModel":{"properties":{},"type":"object","title":"BaseModel"},"Body_function_create_functions_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"shared":{"type":"boolean","title":"Shared","default":false},"response_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Response Format","description":"JSON Schema of run()'s return value, computed by the caller from its pydantic model"}},"type":"object","required":["file"],"title":"Body_function_create_functions_post"},"Body_function_update_functions__function_id__post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"response_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Response Format","description":"JSON Schema of run()'s return value, computed by the caller from its pydantic model"}},"type":"object","required":["file"],"title":"Body_function_update_functions__function_id__post"},"Body_session_cookies_set_sessions__session_id__cookies_post":{"properties":{"cookies":{"items":{"$ref":"#/components/schemas/Cookie"},"type":"array","title":"Cookies"}},"type":"object","required":["cookies"],"title":"Body_session_cookies_set_sessions__session_id__cookies_post"},"Body_upload_session_file_sessions__session_id__files_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_session_file_sessions__session_id__files_post"},"BoundingBox":{"properties":{"x":{"type":"number","title":"X"},"y":{"type":"number","title":"Y"},"width":{"type":"number","title":"Width"},"height":{"type":"number","title":"Height"},"scroll_x":{"type":"number","title":"Scroll X"},"scroll_y":{"type":"number","title":"Scroll Y"},"iframe_offset_x":{"type":"number","title":"Iframe Offset X","default":0},"iframe_offset_y":{"type":"number","title":"Iframe Offset Y","default":0},"viewport_width":{"type":"number","title":"Viewport Width"},"viewport_height":{"type":"number","title":"Viewport Height"},"notte_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notte Id"}},"type":"object","required":["x","y","width","height","scroll_x","scroll_y","viewport_width","viewport_height"],"title":"BoundingBox"},"CaptchaSolveAction":{"properties":{"type":{"type":"string","const":"captcha_solve","title":"Type","default":"captcha_solve"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Solve a CAPTCHA challenge on the current page. CRITICAL: Use this action as soon as you notice a captcha"},"captcha_type":{"anyOf":[{"type":"string","enum":["recaptcha","hcaptcha","image","text","auth0","cloudflare","datadome","arkose labs","geetest","press&hold","unknown"]},{"type":"null"}],"title":"Captcha Type"}},"type":"object","title":"CaptchaSolveAction"},"CheckAction-Input":{"properties":{"type":{"type":"string","const":"check","title":"Type","default":"check"},"category":{"type":"string","minLength":1,"title":"Category","default":"Interaction Actions"},"description":{"type":"string","title":"Description","default":"Check a checkbox. Use `True` to check, `False` to uncheck"},"id":{"type":"string","title":"Id","default":""},"selector":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/NodeSelectors"},{"type":"null"}],"title":"Selector"},"press_enter":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Press Enter"},"text_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Label"},"param":{"anyOf":[{"$ref":"#/components/schemas/ActionParameter"},{"type":"null"}],"default":{"name":"value","type":"bool","values":[]}},"timeout":{"type":"integer","minimum":0.0,"title":"Timeout","description":"Action timeout in milliseconds","default":15000},"value":{"type":"boolean","title":"Value"}},"type":"object","required":["value"],"title":"CheckAction"},"CheckAction-Output":{"properties":{"type":{"type":"string","const":"check","title":"Type","default":"check"},"category":{"type":"string","minLength":1,"title":"Category","default":"Interaction Actions"},"description":{"type":"string","title":"Description","default":"Check a checkbox. Use `True` to check, `False` to uncheck"},"id":{"type":"string","title":"Id","default":""},"selector":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/NodeSelectors"},{"type":"null"}],"title":"Selector"},"press_enter":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Press Enter"},"text_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Label"},"timeout":{"type":"integer","minimum":0.0,"title":"Timeout","description":"Action timeout in milliseconds","default":15000},"value":{"type":"boolean","title":"Value"}},"type":"object","required":["value"],"title":"CheckAction"},"ClickAction-Input":{"properties":{"type":{"type":"string","const":"click","title":"Type","default":"click"},"category":{"type":"string","minLength":1,"title":"Category","default":"Interaction Actions"},"description":{"type":"string","title":"Description","default":"Click on an element of the current page"},"id":{"type":"string","title":"Id","default":""},"selector":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/NodeSelectors"},{"type":"null"}],"title":"Selector"},"press_enter":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Press Enter"},"text_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Label"},"param":{"anyOf":[{"$ref":"#/components/schemas/ActionParameter"},{"type":"null"}]},"timeout":{"type":"integer","minimum":0.0,"title":"Timeout","description":"Action timeout in milliseconds","default":15000}},"type":"object","title":"ClickAction"},"ClickAction-Output":{"properties":{"type":{"type":"string","const":"click","title":"Type","default":"click"},"category":{"type":"string","minLength":1,"title":"Category","default":"Interaction Actions"},"description":{"type":"string","title":"Description","default":"Click on an element of the current page"},"id":{"type":"string","title":"Id","default":""},"selector":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/NodeSelectors"},{"type":"null"}],"title":"Selector"},"press_enter":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Press Enter"},"text_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Label"},"timeout":{"type":"integer","minimum":0.0,"title":"Timeout","description":"Action timeout in milliseconds","default":15000}},"type":"object","title":"ClickAction"},"CloseTabAction":{"properties":{"type":{"type":"string","const":"close_tab","title":"Type","default":"close_tab"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Close the current tab"}},"type":"object","title":"CloseTabAction"},"CompletionAction":{"properties":{"type":{"type":"string","const":"completion","title":"Type","default":"completion"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Complete the task by returning the answer and terminate the browser session"},"success":{"type":"boolean","title":"Success"},"answer":{"type":"string","title":"Answer"}},"type":"object","required":["success","answer"],"title":"CompletionAction"},"ConnectLinkContext":{"properties":{"service_name":{"type":"string","title":"Service Name"},"domain":{"type":"string","title":"Domain"},"logo_color":{"type":"string","title":"Logo Color"},"status":{"type":"string","enum":["pending","submitted","completed","failed","expired"],"title":"Status"},"requires_totp_secret":{"type":"boolean","title":"Requires Totp Secret","description":"Whether the form must collect a TOTP seed."},"requires_mailbox":{"type":"boolean","title":"Requires Mailbox","description":"Whether the connector reads its second factor from email, so the page must ask which inbox the code will arrive in."},"attempts_remaining":{"type":"integer","title":"Attempts Remaining"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"type":"object","required":["service_name","domain","logo_color","status","requires_totp_secret","requires_mailbox","attempts_remaining","expires_at"],"title":"ConnectLinkContext"},"ConnectLinkCreateRequest":{"properties":{"template_id":{"type":"string","title":"Template Id","description":"Connector this link collects credentials for."},"label":{"type":"string","maxLength":120,"minLength":1,"title":"Label","description":"Name the resulting connection is created with."},"external_user_id":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"External User Id","description":"Your own identifier for the end user. Echoed back on the completion webhook."},"two_fa_method":{"anyOf":[{"type":"string","enum":["email","sms","totp"]},{"type":"null"}],"title":"Two Fa Method","description":"Second factor this connection will use. Required when the connector supports more than one, because the choice decides whether a mailbox is needed."},"mailbox_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mailbox Id","description":"Mailbox to read email 2FA codes from. Required when the resolved method is email."},"success_redirect_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Success Redirect Uri","description":"Where the end user is sent once the account is connected."},"error_redirect_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Redirect Uri","description":"Where the end user is sent when the connection cannot be completed."},"webhook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook Url","description":"Receives the signed completion callback. See the connect-link webhook docs."},"ttl_seconds":{"type":"integer","maximum":86400.0,"minimum":60.0,"title":"Ttl Seconds","description":"How long the link stays usable.","default":900},"schedule":{"type":"boolean","title":"Schedule","description":"Whether the resulting connection re-authenticates on a schedule.","default":true}},"type":"object","required":["template_id","label"],"title":"ConnectLinkCreateRequest"},"ConnectLinkCreateResponse":{"properties":{"connect_link_id":{"type":"string","title":"Connect Link Id"},"connect_url":{"type":"string","title":"Connect Url","description":"Send your end user here."},"token":{"type":"string","title":"Token","description":"Returned once and never again - only its hash is stored."},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"webhook_signing_secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook Signing Secret","description":"Workspace secret to verify the completion webhook with. Present only when a webhook_url was supplied. Stable across links, so it is safe to store once."}},"type":"object","required":["connect_link_id","connect_url","token","expires_at"],"title":"ConnectLinkCreateResponse"},"ConnectLinkMailbox":{"properties":{"id":{"type":"string","title":"Id"},"email_address":{"type":"string","title":"Email Address"},"provider":{"type":"string","title":"Provider"},"healthy":{"type":"boolean","title":"Healthy"}},"type":"object","required":["id","email_address","provider","healthy"],"title":"ConnectLinkMailbox"},"ConnectLinkMailboxConnectRequest":{"properties":{"provider":{"type":"string","enum":["gmail","outlook"],"title":"Provider","default":"gmail"}},"type":"object","title":"ConnectLinkMailboxConnectRequest"},"ConnectLinkMailboxConnectResponse":{"properties":{"connect_link_url":{"type":"string","title":"Connect Link Url"},"mailbox_id":{"type":"string","title":"Mailbox Id"}},"type":"object","required":["connect_link_url","mailbox_id"],"title":"ConnectLinkMailboxConnectResponse"},"ConnectLinkMailboxSyncRequest":{"properties":{"mailbox_id":{"type":"string","title":"Mailbox Id"},"provider":{"type":"string","enum":["gmail","outlook"],"title":"Provider","default":"gmail"}},"type":"object","required":["mailbox_id"],"title":"ConnectLinkMailboxSyncRequest"},"ConnectLinkStatusResponse":{"properties":{"status":{"type":"string","enum":["pending","submitted","completed","failed","expired"],"title":"Status"},"connection_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Connection Status"},"failure_code":{"anyOf":[{"type":"string","enum":["invalid_credentials","mfa_required","mfa_invalid","account_locked","captcha","site_changed","transient","unknown"]},{"type":"null"}],"title":"Failure Code"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"attempts_remaining":{"type":"integer","title":"Attempts Remaining"},"success_redirect_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Success Redirect Uri"},"error_redirect_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Redirect Uri"}},"type":"object","required":["status","attempts_remaining"],"title":"ConnectLinkStatusResponse"},"ConnectLinkSubmitRequest":{"properties":{"credentials":{"$ref":"#/components/schemas/ManagedAuthCredentials"},"mailbox_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mailbox Id","description":"Inbox the second-factor code will arrive in. Required when the connector reads its code from email and the link did not already name one."}},"type":"object","required":["credentials"],"title":"ConnectLinkSubmitRequest"},"Cookie":{"properties":{"name":{"type":"string","title":"Name"},"value":{"type":"string","title":"Value"},"domain":{"type":"string","title":"Domain"},"path":{"type":"string","title":"Path"},"httpOnly":{"type":"boolean","title":"Httponly"},"expirationDate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Expirationdate"},"hostOnly":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Hostonly"},"sameSite":{"anyOf":[{"type":"string","enum":["Lax","None","Strict"]},{"type":"null"}],"title":"Samesite"},"secure":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Secure"},"session":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Session"},"storeId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Storeid"},"expires":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Expires"},"partitionKey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Partitionkey"}},"type":"object","required":["name","value","domain","path","httpOnly"],"title":"Cookie"},"Credential":{"properties":{"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"url":{"type":"string","title":"Url"}},"type":"object","required":["username","email","url"],"title":"Credential"},"CredentialsDict-Input":{"properties":{"email":{"type":"string","title":"Email"},"username":{"type":"string","title":"Username"},"password":{"type":"string","title":"Password"},"mfa_secret":{"type":"string","title":"Mfa Secret"}},"additionalProperties":false,"type":"object","required":["password"],"title":"CredentialsDict"},"CredentialsDict-Output":{"properties":{"email":{"type":"string","title":"Email"},"username":{"type":"string","title":"Username"},"password":{"type":"string","title":"Password"},"mfa_secret":{"type":"string","title":"Mfa Secret"}},"type":"object","required":["password"],"title":"CredentialsDict"},"CreditCardDict-Input":{"properties":{"card_holder_name":{"type":"string","title":"Card Holder Name"},"card_number":{"type":"string","title":"Card Number"},"card_cvv":{"type":"string","title":"Card Cvv"},"card_full_expiration":{"type":"string","title":"Card Full Expiration"}},"additionalProperties":false,"type":"object","required":["card_holder_name","card_number","card_cvv","card_full_expiration"],"title":"CreditCardDict"},"CreditCardDict-Output":{"properties":{"card_holder_name":{"type":"string","title":"Card Holder Name"},"card_number":{"type":"string","title":"Card Number"},"card_cvv":{"type":"string","title":"Card Cvv"},"card_full_expiration":{"type":"string","title":"Card Full Expiration"}},"type":"object","required":["card_holder_name","card_number","card_cvv","card_full_expiration"],"title":"CreditCardDict"},"DataSpace":{"properties":{"markdown":{"type":"string","title":"Markdown","description":"Markdown representation of the extracted data"},"images":{"anyOf":[{"items":{"$ref":"#/components/schemas/ImageData"},"type":"array"},{"type":"null"}],"title":"Images","description":"List of images extracted from the page (ID and download link)"},"structured":{"anyOf":[{"$ref":"#/components/schemas/StructuredData_BaseModel_"},{"type":"null"}],"description":"Structured data extracted from the page in JSON format"}},"type":"object","required":["markdown"],"title":"DataSpace"},"DeleteCredentialsResponse":{"properties":{"status":{"type":"string","enum":["success","failure"],"title":"Status","description":"Status of the deletion"},"message":{"type":"string","title":"Message","description":"Message of the deletion","default":"Credentials deleted successfully"}},"type":"object","required":["status"],"title":"DeleteCredentialsResponse"},"DeleteCreditCardResponse":{"properties":{"status":{"type":"string","enum":["success","failure"],"title":"Status","description":"Status of the deletion"},"message":{"type":"string","title":"Message","description":"Message of the deletion","default":"Credit card deleted successfully"}},"type":"object","required":["status"],"title":"DeleteCreditCardResponse"},"DeleteFunctionResponse":{"properties":{"status":{"type":"string","enum":["success","failure"],"title":"Status","description":"The status of the deletion"},"message":{"type":"string","title":"Message","description":"The message of the deletion"}},"type":"object","required":["status","message"],"title":"DeleteFunctionResponse"},"DeletePersonaResponse":{"properties":{"status":{"type":"string","enum":["success","failure"],"title":"Status","description":"Status of the deletion"},"message":{"type":"string","title":"Message","description":"Message of the deletion","default":"Persona deleted successfully"}},"type":"object","required":["status"],"title":"DeletePersonaResponse"},"DeleteVaultResponse":{"properties":{"status":{"type":"string","enum":["success","failure"],"title":"Status","description":"Status of the deletion"},"message":{"type":"string","title":"Message","description":"Message of the deletion","default":"Vault deleted successfully"}},"type":"object","required":["status"],"title":"DeleteVaultResponse"},"DownloadFileAction-Input":{"properties":{"type":{"type":"string","const":"download_file","title":"Type","default":"download_file"},"category":{"type":"string","minLength":1,"title":"Category","default":"Interaction Actions"},"description":{"type":"string","title":"Description","default":"Download files from interactive elements. Use with any clickable element which triggers a download, including button, a, div. This action can also be used to download pages which are raw files (ex. PDF viewer). CRITICAL: Use only this for file download, DO NOT use click."},"id":{"type":"string","title":"Id","default":""},"selector":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/NodeSelectors"},{"type":"null"}],"title":"Selector"},"press_enter":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Press Enter"},"text_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Label"},"param":{"anyOf":[{"$ref":"#/components/schemas/ActionParameter"},{"type":"null"}]},"timeout":{"type":"integer","minimum":0.0,"title":"Timeout","description":"Action timeout in milliseconds","default":15000}},"type":"object","title":"DownloadFileAction"},"DownloadFileAction-Output":{"properties":{"type":{"type":"string","const":"download_file","title":"Type","default":"download_file"},"category":{"type":"string","minLength":1,"title":"Category","default":"Interaction Actions"},"description":{"type":"string","title":"Description","default":"Download files from interactive elements. Use with any clickable element which triggers a download, including button, a, div. This action can also be used to download pages which are raw files (ex. PDF viewer). CRITICAL: Use only this for file download, DO NOT use click."},"id":{"type":"string","title":"Id","default":""},"selector":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/NodeSelectors"},{"type":"null"}],"title":"Selector"},"press_enter":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Press Enter"},"text_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Label"},"timeout":{"type":"integer","minimum":0.0,"title":"Timeout","description":"Action timeout in milliseconds","default":15000}},"type":"object","title":"DownloadFileAction"},"EmailReadAction":{"properties":{"type":{"type":"string","const":"email_read","title":"Type","default":"email_read"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Read recent emails from the mailbox."},"limit":{"type":"integer","title":"Limit","description":"Max number of emails to return","default":10},"timedelta":{"anyOf":[{"type":"string","format":"duration"},{"type":"null"}],"title":"Timedelta","description":"Return only emails that are not older than `timedelta`","default":"PT5M"},"only_unread":{"type":"boolean","title":"Only Unread","description":"Return only previously unread emails","default":true}},"type":"object","title":"EmailReadAction"},"EmailResponse":{"properties":{"subject":{"type":"string","title":"Subject","description":"Subject of the email"},"email_id":{"type":"string","title":"Email Id","description":"Email UUID"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation date"},"sender_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sender Email","description":"Email address of the sender"},"sender_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sender Name","description":"Name (if available) of the sender"},"text_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Content","description":"Raw textual body, can be uncorrelated with html content"},"html_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Html Content","description":"HTML body, can be uncorrelated with raw content"}},"type":"object","required":["subject","email_id","created_at","sender_email","sender_name"],"title":"EmailResponse"},"EmailVerificationReadAction":{"properties":{"type":{"type":"string","const":"email_verification_read","title":"Type","default":"email_verification_read"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Read a recent verification code or link from an approved sender domain."},"mailbox_id":{"type":"string","minLength":1,"title":"Mailbox Id","description":"Workspace mailbox connection to read the verification email from"},"sender_domain":{"type":"string","minLength":1,"title":"Sender Domain","description":"Sender domain to search, such as example.com"},"max_age_seconds":{"type":"integer","maximum":900.0,"minimum":30.0,"title":"Max Age Seconds","description":"Maximum age of the verification email in seconds","default":300}},"type":"object","required":["mailbox_id","sender_domain"],"title":"EmailVerificationReadAction"},"EvaluateJsAction":{"properties":{"type":{"type":"string","const":"evaluate_js","title":"Type","default":"evaluate_js"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Evaluate JavaScript code on the current page and return the result. For simple cases, provide a single expression (e.g. `document.title`). For multi-statement code, wrap in an IIFE: `(() => { ...; return result; })()`"},"code":{"type":"string","title":"Code","description":"The JavaScript code to evaluate on the page. Use a single expression or an IIFE for multi-statement code."}},"type":"object","required":["code"],"title":"EvaluateJsAction"},"ExecutionResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the operation was successful"},"message":{"type":"string","title":"Message","description":"A message describing the operation"}},"type":"object","required":["success","message"],"title":"ExecutionResponse"},"ExternalProxy":{"properties":{"type":{"type":"string","const":"external","title":"Type","default":"external"},"server":{"type":"string","title":"Server"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"password":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Password"},"bypass":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bypass"}},"additionalProperties":false,"type":"object","required":["server"],"title":"ExternalProxy"},"FallbackFillAction-Input":{"properties":{"type":{"type":"string","const":"fallback_fill","title":"Type","default":"fallback_fill"},"category":{"type":"string","minLength":1,"title":"Category","default":"Interaction Actions"},"description":{"type":"string","title":"Description","default":"Fill an input field with a value. Only use if explicitly asked, or you failed to input with the normal fill action"},"id":{"type":"string","title":"Id","default":""},"selector":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/NodeSelectors"},{"type":"null"}],"title":"Selector"},"press_enter":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Press Enter"},"text_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Label"},"param":{"anyOf":[{"$ref":"#/components/schemas/ActionParameter"},{"type":"null"}],"default":{"name":"value","type":"str","values":[]}},"timeout":{"type":"integer","minimum":0.0,"title":"Timeout","description":"Action timeout in milliseconds","default":15000},"value":{"anyOf":[{"type":"string"},{"type":"string","format":"password","writeOnly":true}],"title":"Value"},"clear_before_fill":{"type":"boolean","title":"Clear Before Fill","default":true}},"type":"object","required":["value"],"title":"FallbackFillAction"},"FallbackFillAction-Output":{"properties":{"type":{"type":"string","const":"fallback_fill","title":"Type","default":"fallback_fill"},"category":{"type":"string","minLength":1,"title":"Category","default":"Interaction Actions"},"description":{"type":"string","title":"Description","default":"Fill an input field with a value. Only use if explicitly asked, or you failed to input with the normal fill action"},"id":{"type":"string","title":"Id","default":""},"selector":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/NodeSelectors"},{"type":"null"}],"title":"Selector"},"press_enter":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Press Enter"},"text_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Label"},"timeout":{"type":"integer","minimum":0.0,"title":"Timeout","description":"Action timeout in milliseconds","default":15000},"value":{"anyOf":[{"type":"string"},{"type":"string","format":"password","writeOnly":true}],"title":"Value"},"clear_before_fill":{"type":"boolean","title":"Clear Before Fill","default":true}},"type":"object","required":["value"],"title":"FallbackFillAction"},"FileSource":{"type":"string","enum":["user_upload","session_download"],"title":"FileSource"},"FillAction-Input":{"properties":{"type":{"type":"string","const":"fill","title":"Type","default":"fill"},"category":{"type":"string","minLength":1,"title":"Category","default":"Interaction Actions"},"description":{"type":"string","title":"Description","default":"Fill an input field with a value"},"id":{"type":"string","title":"Id","default":""},"selector":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/NodeSelectors"},{"type":"null"}],"title":"Selector"},"press_enter":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Press Enter"},"text_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Label"},"param":{"anyOf":[{"$ref":"#/components/schemas/ActionParameter"},{"type":"null"}],"default":{"name":"value","type":"str","values":[]}},"timeout":{"type":"integer","minimum":0.0,"title":"Timeout","description":"Action timeout in milliseconds","default":15000},"value":{"anyOf":[{"type":"string"},{"type":"string","format":"password","writeOnly":true}],"title":"Value"},"clear_before_fill":{"type":"boolean","title":"Clear Before Fill","default":true}},"type":"object","required":["value"],"title":"FillAction"},"FillAction-Output":{"properties":{"type":{"type":"string","const":"fill","title":"Type","default":"fill"},"category":{"type":"string","minLength":1,"title":"Category","default":"Interaction Actions"},"description":{"type":"string","title":"Description","default":"Fill an input field with a value"},"id":{"type":"string","title":"Id","default":""},"selector":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/NodeSelectors"},{"type":"null"}],"title":"Selector"},"press_enter":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Press Enter"},"text_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Label"},"timeout":{"type":"integer","minimum":0.0,"title":"Timeout","description":"Action timeout in milliseconds","default":15000},"value":{"anyOf":[{"type":"string"},{"type":"string","format":"password","writeOnly":true}],"title":"Value"},"clear_before_fill":{"type":"boolean","title":"Clear Before Fill","default":true}},"type":"object","required":["value"],"title":"FillAction"},"FormFillAction":{"properties":{"type":{"type":"string","const":"form_fill","title":"Type","default":"form_fill"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Fill a form with multiple values. Important: If you detect a form requesting personal information, try to use this action at first, and otherwise use the regular fill action. CRITICAL: If this action fails once, use the regular form fill instead."},"value":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"string","format":"password","writeOnly":true}]},"propertyNames":{"enum":["title","first_name","middle_name","last_name","full_name","email","company","address1","address2","address3","city","state","postal_code","country","phone","cc_name","cc_number","cc_exp_month","cc_exp_year","cc_exp","cc_cvv","username","password","current_password","new_password","totp"]},"type":"object","minProperties":1,"title":"Value"}},"type":"object","required":["value"],"title":"FormFillAction"},"FrameData":{"properties":{"frameUrl":{"type":"string","title":"Frameurl","description":"URL of the frame"},"frameData":{"type":"string","title":"Framedata","description":"DOM Content of the frame"}},"type":"object","required":["frameUrl","frameData"],"title":"FrameData"},"FunctionListItemResponse":{"properties":{"default_runtime":{"type":"string","enum":["standard","extended"],"title":"Default Runtime","default":"standard"},"function_id":{"type":"string","title":"Function Id","description":"The ID of the function"},"variables":{"anyOf":[{"items":{"$ref":"#/components/schemas/ParameterInfo"},"type":"array"},{"type":"null"}],"title":"Variables","description":"The variables to run the workflow with"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"The creation time of the workflow"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"The last update time of the workflow"},"latest_version":{"type":"string","title":"Latest Version","description":"The version of the workflow"},"versions":{"items":{"type":"string"},"type":"array","title":"Versions","description":"The versions of the workflow"},"status":{"type":"string","title":"Status","description":"The status of the workflow"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"The name of the workflow"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"The description of the workflow"},"shared":{"type":"boolean","title":"Shared","description":"Whether the workflow is public and can beshared with other users","default":false},"reference_workflow_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference Workflow Id","description":"The ID of the reference workflow (i.e wether the workflow was forked from another workflow or not)"},"published":{"type":"boolean","title":"Published","default":false},"required_secrets":{"items":{"type":"string"},"type":"array","title":"Required Secrets"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","description":"Where the function was created from, stamped at creation. Read-only."},"self_healing":{"type":"boolean","title":"Self Healing","description":"Whether the build is finished and the function may be healed automatically. Can only be enabled on a function that has a thread for self-heal to resume.","default":false},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","description":"The site this function drives, used to group endpoints in the console. Null when the function never named a site."},"workflow_id":{"type":"string","title":"Workflow Id","readOnly":true}},"type":"object","required":["function_id","created_at","updated_at","latest_version","versions","status","workflow_id"],"title":"FunctionListItemResponse"},"FunctionMetadataUpdateRequest":{"properties":{"default_runtime":{"anyOf":[{"type":"string","enum":["standard","extended"]},{"type":"null"}],"title":"Default Runtime"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"self_healing":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Self Healing"},"response_format":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Response Format","description":"JSON Schema of run()'s return value, computed by the caller from its pydantic model"}},"type":"object","title":"FunctionMetadataUpdateRequest"},"FunctionResponse":{"properties":{"default_runtime":{"type":"string","enum":["standard","extended"],"title":"Default Runtime","default":"standard"},"function_id":{"type":"string","title":"Function Id","description":"The ID of the function"},"variables":{"anyOf":[{"items":{"$ref":"#/components/schemas/ParameterInfo"},"type":"array"},{"type":"null"}],"title":"Variables","description":"The variables to run the workflow with"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"The creation time of the workflow"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"The last update time of the workflow"},"latest_version":{"type":"string","title":"Latest Version","description":"The version of the workflow"},"versions":{"items":{"type":"string"},"type":"array","title":"Versions","description":"The versions of the workflow"},"status":{"type":"string","title":"Status","description":"The status of the workflow"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"The name of the workflow"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"The description of the workflow"},"shared":{"type":"boolean","title":"Shared","description":"Whether the workflow is public and can beshared with other users","default":false},"reference_workflow_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference Workflow Id","description":"The ID of the reference workflow (i.e wether the workflow was forked from another workflow or not)"},"published":{"type":"boolean","title":"Published","default":false},"required_secrets":{"items":{"type":"string"},"type":"array","title":"Required Secrets"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","description":"Where the function was created from, stamped at creation. Read-only."},"self_healing":{"type":"boolean","title":"Self Healing","description":"Whether the build is finished and the function may be healed automatically. Can only be enabled on a function that has a thread for self-heal to resume.","default":false},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","description":"The site this function drives, used to group endpoints in the console. Null when the function never named a site."},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions","description":"Builder's operating notes: typical run duration, known failure modes, which parameters matter."},"response_format":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Response Format","description":"JSON Schema of the value run() returns, or null when the author never documented one."},"schedule_cron":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Schedule Cron","description":"Cron expression the function runs on, or null if it is not scheduled."},"schedule_variables":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Schedule Variables","description":"Variables passed to each scheduled run, or null if it is not scheduled."},"schedule_state":{"anyOf":[{"type":"string","enum":["enabled","paused"]},{"type":"null"}],"title":"Schedule State","description":"'enabled' while the schedule fires, 'paused' once the backend disabled it after a deterministic failure (exhausted credit, or an inactive function), null when there is no schedule."},"workflow_id":{"type":"string","title":"Workflow Id","readOnly":true}},"type":"object","required":["function_id","created_at","updated_at","latest_version","versions","status","workflow_id"],"title":"FunctionResponse"},"FunctionRollbackRequest":{"properties":{"version":{"type":"string","title":"Version","description":"A version from the function's `versions` history to restore"}},"type":"object","required":["version"],"title":"FunctionRollbackRequest"},"FunctionRunListItemResponse":{"properties":{"function_id":{"type":"string","title":"Function Id","description":"The ID of the function"},"function_run_id":{"type":"string","title":"Function Run Id","description":"The ID of the function run"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"status":{"type":"string","enum":["closed","active","failed"],"title":"Status"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"local":{"type":"boolean","title":"Local","default":false},"workflow_id":{"type":"string","title":"Workflow Id","readOnly":true},"workflow_run_id":{"type":"string","title":"Workflow Run Id","readOnly":true}},"type":"object","required":["function_id","function_run_id","created_at","updated_at","status","workflow_id","workflow_run_id"],"title":"FunctionRunListItemResponse"},"FunctionRunUpdateRequest":{"properties":{"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id","description":"The ID of the session"},"logs":{"items":{"type":"string"},"type":"array","title":"Logs","description":"The logs of the workflow run"},"variables":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Variables","description":"The variables of the workflow run"},"result":{"anyOf":[{},{"type":"null"}],"title":"Result","description":"The result of the workflow run"},"status":{"type":"string","enum":["closed","active","failed"],"title":"Status","description":"The status of the workflow run"}},"additionalProperties":false,"type":"object","required":["status"],"title":"FunctionRunUpdateRequest"},"FunctionRuntimeHealthResponse":{"properties":{"status":{"type":"string","enum":["ok","degraded","unreachable"],"title":"Status","description":"'ok' when the runtime reported itself, 'degraded' when it is alive but too old to describe itself (its image predates this endpoint), 'unreachable' when it did not answer."},"reachable":{"type":"boolean","title":"Reachable","description":"Whether the runtime answered an HTTP request at all."},"latency_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latency Ms","description":"Round trip to the runtime, null when unreachable."},"python_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Python Version","description":"Python the sandbox executes under, e.g. '3.12.0'."},"packages":{"items":{"$ref":"#/components/schemas/RuntimePackage"},"type":"array","title":"Packages","description":"Non-stdlib imports the sandbox allows, with versions."},"stdlib_modules":{"items":{"type":"string"},"type":"array","title":"Stdlib Modules","description":"Standard-library modules the sandbox allows. Versionless: the Python version covers them."},"reserved_env_names":{"items":{"type":"string"},"type":"array","title":"Reserved Env Names","description":"`function_env` names the platform owns, rejected at write time. Served here so a client validating secret names before pushing them does not have to vendor its own copy and watch it drift."},"runtime_digest":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Runtime Digest","description":"Digest of the reproducible contract - Python version, packages with their sources, allowed imports, reserved names - and nothing volatile, so it changes if and only if an environment built against it would now be wrong. Cache against it to detect a runner rebuild. Null unless `status` is 'ok', since a partial report is not a contract. Also returned as the response ETag."},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Why the probe failed, when it did."}},"type":"object","required":["status","reachable"],"title":"FunctionRuntimeHealthResponse"},"FunctionScheduleCreateRequest":{"properties":{"cron":{"type":"string","title":"Cron","description":"AWS EventBridge schedule expression. Six space-separated fields, minutes first: `minutes hours day-of-month month day-of-week year`. This is neither five-field Unix crontab nor the seconds-first six-field dialect used by Quartz and cron-parser. Exactly one of day-of-month and day-of-week must be `?`, the other must be a real value. Schedules fire in UTC. Example: `0 12 ? * * *` runs daily at noon UTC. `rate(...)` expressions such as `rate(1 hour)` are accepted too."},"variables":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Variables","description":"Values passed to the function on every scheduled run. Must supply every function variable that has no default, and no names the function does not declare."}},"type":"object","required":["cron","variables"],"title":"FunctionScheduleCreateRequest"},"FunctionSource":{"type":"string","enum":["console","anything","cli","node-sdk","python-sdk","rest-api"],"title":"FunctionSource"},"FunctionWithLinkResponse":{"properties":{"url":{"type":"string","title":"Url","description":"URL to download file from"},"default_runtime":{"type":"string","enum":["standard","extended"],"title":"Default Runtime","default":"standard"},"function_id":{"type":"string","title":"Function Id","description":"The ID of the function"},"variables":{"anyOf":[{"items":{"$ref":"#/components/schemas/ParameterInfo"},"type":"array"},{"type":"null"}],"title":"Variables","description":"The variables to run the workflow with"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"The creation time of the workflow"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"The last update time of the workflow"},"latest_version":{"type":"string","title":"Latest Version","description":"The version of the workflow"},"versions":{"items":{"type":"string"},"type":"array","title":"Versions","description":"The versions of the workflow"},"status":{"type":"string","title":"Status","description":"The status of the workflow"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"The name of the workflow"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"The description of the workflow"},"shared":{"type":"boolean","title":"Shared","description":"Whether the workflow is public and can beshared with other users","default":false},"reference_workflow_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference Workflow Id","description":"The ID of the reference workflow (i.e wether the workflow was forked from another workflow or not)"},"published":{"type":"boolean","title":"Published","default":false},"required_secrets":{"items":{"type":"string"},"type":"array","title":"Required Secrets"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","description":"Where the function was created from, stamped at creation. Read-only."},"self_healing":{"type":"boolean","title":"Self Healing","description":"Whether the build is finished and the function may be healed automatically. Can only be enabled on a function that has a thread for self-heal to resume.","default":false},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","description":"The site this function drives, used to group endpoints in the console. Null when the function never named a site."},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions","description":"Builder's operating notes: typical run duration, known failure modes, which parameters matter."},"response_format":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Response Format","description":"JSON Schema of the value run() returns, or null when the author never documented one."},"schedule_cron":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Schedule Cron","description":"Cron expression the function runs on, or null if it is not scheduled."},"schedule_variables":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Schedule Variables","description":"Variables passed to each scheduled run, or null if it is not scheduled."},"schedule_state":{"anyOf":[{"type":"string","enum":["enabled","paused"]},{"type":"null"}],"title":"Schedule State","description":"'enabled' while the schedule fires, 'paused' once the backend disabled it after a deterministic failure (exhausted credit, or an inactive function), null when there is no schedule."},"workflow_id":{"type":"string","title":"Workflow Id","readOnly":true}},"type":"object","required":["url","function_id","created_at","updated_at","latest_version","versions","status","workflow_id"],"title":"FunctionWithLinkResponse"},"GetCookiesResponse":{"properties":{"cookies":{"items":{"$ref":"#/components/schemas/Cookie"},"type":"array","title":"Cookies"}},"type":"object","required":["cookies"],"title":"GetCookiesResponse"},"GetCredentialsResponse":{"properties":{"credentials":{"$ref":"#/components/schemas/CredentialsDict-Output","description":"Retrieved credentials"}},"type":"object","required":["credentials"],"title":"GetCredentialsResponse"},"GetCreditCardResponse":{"properties":{"credit_card":{"$ref":"#/components/schemas/CreditCardDict-Output","description":"Retrieved credit card"}},"type":"object","required":["credit_card"],"title":"GetCreditCardResponse"},"GetFunctionRunResponse":{"properties":{"function_id":{"type":"string","title":"Function Id","description":"The ID of the function"},"function_run_id":{"type":"string","title":"Function Run Id","description":"The ID of the function run"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"status":{"type":"string","enum":["closed","active","failed"],"title":"Status"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id","description":"The ID of the session"},"logs":{"items":{"type":"string"},"type":"array","title":"Logs","description":"The logs of the workflow run"},"variables":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Variables","description":"The variables of the workflow run"},"result":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Result","description":"The result of the workflow run (if any)"},"local":{"type":"boolean","title":"Local","description":"Whether the workflow has been run locally or on the cloud","default":false},"workflow_id":{"type":"string","title":"Workflow Id","readOnly":true},"workflow_run_id":{"type":"string","title":"Workflow Run Id","readOnly":true}},"type":"object","required":["function_id","function_run_id","created_at","updated_at","status","workflow_id","workflow_run_id"],"title":"GetFunctionRunResponse"},"GlobalScrapeRequest":{"properties":{"solve_captchas":{"type":"boolean","title":"Solve Captchas","description":"Whether to try to automatically solve captchas","default":true},"max_duration_minutes":{"type":"integer","maximum":1440.0,"exclusiveMinimum":0.0,"title":"Max Duration Minutes","description":"Maximum session lifetime in minutes (absolute maximum, not affected by activity).","default":15},"idle_timeout_minutes":{"type":"integer","maximum":30.0,"exclusiveMinimum":0.0,"title":"Idle Timeout Minutes","description":"Idle timeout in minutes. Session closes after this period of inactivity (resets on each operation).","default":3},"proxies":{"anyOf":[{"items":{"oneOf":[{"$ref":"#/components/schemas/NotteProxy"},{"$ref":"#/components/schemas/ExternalProxy"},{"$ref":"#/components/schemas/TailnetProxy"}],"discriminator":{"propertyName":"type","mapping":{"external":"#/components/schemas/ExternalProxy","notte":"#/components/schemas/NotteProxy","tailnet":"#/components/schemas/TailnetProxy"}}},"type":"array"},{"type":"boolean"}],"title":"Proxies","description":"List of custom proxies to use for the session. If True, the default proxies will be used.","default":true},"browser_type":{"type":"string","enum":["chromium","chrome","chrome-nightly","chrome-turbo"],"title":"Browser Type","description":"The browser type to use. Supported values are chromium and chrome. chrome-nightly and chrome-turbo are legacy aliases for chrome.","default":"chromium"},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent","description":"The user agent to use for the session"},"chrome_args":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Chrome Args","description":"Overwrite the chrome instance arguments"},"viewport_width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Viewport Width","description":"The width of the viewport"},"viewport_height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Viewport Height","description":"The height of the viewport"},"aspect_ratio":{"anyOf":[{"type":"string","enum":["5:4","16:9"]},{"type":"null"}],"title":"Aspect Ratio","description":"Viewport shape preset. When set, the backend fits the largest rectangle of this aspect ratio inside the sampled available screen area. Cannot be combined with explicit viewport_width/viewport_height."},"cdp_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cdp Url","description":"The CDP URL of another remote session provider."},"screenshot_type":{"type":"string","enum":["raw","full","last_action"],"title":"Screenshot Type","description":"The type of screenshot to use for the session.","default":"last_action"},"profile":{"anyOf":[{"$ref":"#/components/schemas/SessionProfile"},{"type":"null"}],"description":"Browser profile configuration for state persistence"},"web_bot_auth":{"type":"boolean","title":"Web Bot Auth","description":"Whether to use web bot authentication.","default":false},"extra_http_headers":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Extra Http Headers","description":"Extra HTTP headers to be sent with every request."},"vault_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vault Id","description":"The vault to use for the session"},"auth_ids":{"items":{"type":"string"},"type":"array","maxItems":10,"title":"Auth Ids","description":"Managed Auth connection IDs to verify and, when necessary, authenticate inside this session before it is returned."},"wait_for_authentication":{"type":"boolean","title":"Wait For Authentication","description":"Whether to wait for Managed Auth before returning the session. Defaults to true. When true, authentication failure or timeout fails session creation; when false, authentication continues in the background after the browser is ready.","default":true},"advanced_stealth":{"type":"boolean","title":"Advanced Stealth","description":"Enable Notte's highest-fidelity browser environment for sites with sophisticated bot detection. Available to approved workspaces.","default":false},"selector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selector","description":"Playwright selector to scope the scrape to. Only content inside this selector will be scraped."},"scrape_links":{"type":"boolean","title":"Scrape Links","description":"Whether to scrape links from the page. Links are scraped by default.","default":true},"scrape_images":{"type":"boolean","title":"Scrape Images","description":"Whether to scrape images from the page. Images are scraped by default.","default":false},"ignored_tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ignored Tags","description":"HTML tags to ignore from the page"},"only_main_content":{"type":"boolean","title":"Only Main Content","description":"Whether to only scrape the main content of the page. If True, navbars, footers, etc. are excluded.","default":false},"only_images":{"type":"boolean","title":"Only Images","description":"Whether to only scrape images from the page. If True, the page content is excluded.","default":false},"response_format":{"anyOf":[{},{"type":"null"}],"title":"Response Format","description":"The response format to use for the scrape. You can use a Pydantic model or a JSON Schema dict (cf. https://docs.pydantic.dev/latest/concepts/json_schema/#generating-json-schema.)"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions","description":"Additional instructions to use for the scrape. E.g. 'Extract only the title, date and content of the articles.'"},"use_link_placeholders":{"type":"boolean","title":"Use Link Placeholders","description":"Whether to use link/image placeholders to reduce the number of tokens in the prompt and hallucinations. However this is an experimental feature and might not work as expected.","default":false},"url":{"type":"string","title":"Url"}},"additionalProperties":false,"type":"object","required":["url"],"title":"GlobalScrapeRequest"},"GoBackAction":{"properties":{"type":{"type":"string","const":"go_back","title":"Type","default":"go_back"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Go back to the previous page (in current tab)"}},"type":"object","title":"GoBackAction"},"GoForwardAction":{"properties":{"type":{"type":"string","const":"go_forward","title":"Type","default":"go_forward"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Go forward to the next page (in current tab)"}},"type":"object","title":"GoForwardAction"},"GotoAction":{"properties":{"type":{"type":"string","const":"goto","title":"Type","default":"goto"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Goto to a URL (in current tab)"},"url":{"type":"string","title":"Url"},"wait_until":{"anyOf":[{"type":"string","enum":["commit","domcontentloaded","load","networkidle"]},{"type":"null"}],"title":"Wait Until"}},"additionalProperties":false,"type":"object","required":["url"],"title":"GotoAction"},"GotoNewTabAction":{"properties":{"type":{"type":"string","const":"goto_new_tab","title":"Type","default":"goto_new_tab"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Goto to a URL (in new tab)"},"url":{"type":"string","title":"Url"}},"type":"object","required":["url"],"title":"GotoNewTabAction"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status","default":"healthy"},"version":{"type":"string","title":"Version","default":"1.4.40"},"description":{"type":"string","title":"Description","default":"Notte API is healthy and ready to serve requests. Docs available at https://docs.notte.cc"}},"type":"object","title":"HealthResponse"},"HelpAction":{"properties":{"type":{"type":"string","const":"help","title":"Type","default":"help"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Ask for clarification"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["reason"],"title":"HelpAction"},"ImageCategory":{"type":"string","enum":["favicon","icon","content_image","decorative","svg_icon","svg_content"],"title":"ImageCategory"},"ImageData":{"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of the image"},"category":{"anyOf":[{"$ref":"#/components/schemas/ImageCategory"},{"type":"null"}],"description":"Category of the image (icon, svg, content, etc.)"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the image"}},"type":"object","title":"ImageData"},"ImprovePromptRequest":{"properties":{"prompt":{"type":"string","title":"Prompt"}},"type":"object","required":["prompt"],"title":"ImprovePromptRequest"},"ImprovePromptResponse":{"properties":{"prompt":{"type":"string","title":"Prompt"},"variables":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Variables"}},"type":"object","required":["prompt"],"title":"ImprovePromptResponse"},"LegacyAgentStatusResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id","description":"The ID of the agent"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"The creation time of the agent"},"session_id":{"type":"string","title":"Session Id","description":"The ID of the session"},"status":{"$ref":"#/components/schemas/AgentStatus","description":"The status of the agent (active or closed)"},"closed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Closed At","description":"The closing time of the agent"},"saved":{"type":"boolean","title":"Saved","description":"Whether the agent is saved as a workflow","default":false},"task":{"type":"string","title":"Task","description":"The task that the agent is currently running"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"The URL that the agent started on"},"success":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Success","description":"Whether the agent task was successful. None if the agent is still running"},"answer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Answer","description":"The answer to the agent task. None if the agent is still running"},"steps":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Steps"}},"type":"object","required":["agent_id","created_at","session_id","status","task"],"title":"LegacyAgentStatusResponse"},"ListCredentialsResponse":{"properties":{"credentials":{"items":{"$ref":"#/components/schemas/Credential"},"type":"array","title":"Credentials","description":"URLs for which we hold credentials"}},"type":"object","required":["credentials"],"title":"ListCredentialsResponse"},"LlmModel":{"type":"string","enum":["openai/gpt-4o","gemini/gemini-2.5-flash","vertex_ai/gemini-2.5-flash","openrouter/google/gemma-3-27b-it","cerebras/gpt-oss-120b","groq/gpt-oss-120b","perplexity/sonar-pro","deepseek/deepseek-r1","together_ai/meta-llama/llama-3.3-70b-instruct","anthropic/claude-sonnet-4-5-20250929","moonshot/kimi-k2.5","xai/grok-4-1-fast-non-reasoning","minimax/minimax-m2.5"],"title":"LlmModel"},"MailboxConnectRequest":{"properties":{"provider":{"type":"string","enum":["gmail","microsoft_outlook"],"title":"Provider","default":"gmail"},"success_redirect_uri":{"type":"string","title":"Success Redirect Uri"},"error_redirect_uri":{"type":"string","title":"Error Redirect Uri"},"allowed_origin":{"type":"string","title":"Allowed Origin"},"mailbox_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mailbox Id"}},"type":"object","required":["success_redirect_uri","error_redirect_uri","allowed_origin"],"title":"MailboxConnectRequest"},"MailboxConnectResponse":{"properties":{"connect_link_url":{"type":"string","title":"Connect Link Url"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"mailbox_id":{"type":"string","title":"Mailbox Id"}},"type":"object","required":["connect_link_url","mailbox_id"],"title":"MailboxConnectResponse"},"MailboxConnection":{"properties":{"id":{"type":"string","title":"Id"},"provider":{"type":"string","enum":["gmail","microsoft_outlook"],"title":"Provider","default":"gmail"},"email_address":{"type":"string","title":"Email Address"},"healthy":{"type":"boolean","title":"Healthy","default":true},"authorized_scopes":{"items":{"type":"string"},"type":"array","title":"Authorized Scopes"},"allow_all_senders":{"type":"boolean","title":"Allow All Senders","default":true},"allowed_sender_domains":{"items":{"type":"string"},"type":"array","title":"Allowed Sender Domains"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","email_address"],"title":"MailboxConnection"},"MailboxListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/MailboxConnection"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"MailboxListResponse"},"MailboxSyncRequest":{"properties":{"mailbox_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mailbox Id"},"provider":{"anyOf":[{"type":"string","enum":["gmail","microsoft_outlook"]},{"type":"null"}],"title":"Provider"}},"type":"object","title":"MailboxSyncRequest"},"MailboxUpdateRequest":{"properties":{"allow_all_senders":{"type":"boolean","title":"Allow All Senders"},"allowed_sender_domains":{"items":{"type":"string"},"type":"array","maxItems":100,"title":"Allowed Sender Domains"}},"type":"object","required":["allow_all_senders"],"title":"MailboxUpdateRequest"},"ManagedAuthCredentials":{"properties":{"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"password":{"type":"string","format":"password","title":"Password","writeOnly":true},"mfa_secret":{"anyOf":[{"type":"string","format":"password","writeOnly":true},{"type":"null"}],"title":"Mfa Secret"}},"type":"object","required":["password"],"title":"ManagedAuthCredentials"},"MultiFactorFillAction-Input":{"properties":{"type":{"type":"string","const":"multi_factor_fill","title":"Type","default":"multi_factor_fill"},"category":{"type":"string","minLength":1,"title":"Category","default":"Interaction Actions"},"description":{"type":"string","title":"Description","default":"Fill an MFA input field with a value. CRITICAL: Only use it when filling in an OTP."},"id":{"type":"string","title":"Id","default":""},"selector":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/NodeSelectors"},{"type":"null"}],"title":"Selector"},"press_enter":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Press Enter"},"text_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Label"},"param":{"anyOf":[{"$ref":"#/components/schemas/ActionParameter"},{"type":"null"}],"default":{"name":"value","type":"str","values":[]}},"timeout":{"type":"integer","minimum":0.0,"title":"Timeout","description":"Action timeout in milliseconds","default":15000},"value":{"anyOf":[{"type":"string"},{"type":"string","format":"password","writeOnly":true}],"title":"Value"},"clear_before_fill":{"type":"boolean","title":"Clear Before Fill","default":true}},"type":"object","required":["value"],"title":"MultiFactorFillAction"},"MultiFactorFillAction-Output":{"properties":{"type":{"type":"string","const":"multi_factor_fill","title":"Type","default":"multi_factor_fill"},"category":{"type":"string","minLength":1,"title":"Category","default":"Interaction Actions"},"description":{"type":"string","title":"Description","default":"Fill an MFA input field with a value. CRITICAL: Only use it when filling in an OTP."},"id":{"type":"string","title":"Id","default":""},"selector":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/NodeSelectors"},{"type":"null"}],"title":"Selector"},"press_enter":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Press Enter"},"text_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Label"},"timeout":{"type":"integer","minimum":0.0,"title":"Timeout","description":"Action timeout in milliseconds","default":15000},"value":{"anyOf":[{"type":"string"},{"type":"string","format":"password","writeOnly":true}],"title":"Value"},"clear_before_fill":{"type":"boolean","title":"Clear Before Fill","default":true}},"type":"object","required":["value"],"title":"MultiFactorFillAction"},"NetworkBatchFile":{"properties":{"key":{"type":"string","title":"Key"},"size":{"type":"integer","title":"Size"},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Download Url"},"download_url_expires_in_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Download Url Expires In Seconds"}},"type":"object","required":["key","size"],"title":"NetworkBatchFile"},"NetworkLogsResponse":{"properties":{"session_id":{"type":"string","title":"Session Id"},"format":{"type":"string","title":"Format","default":"batched_v1"},"batches":{"items":{"$ref":"#/components/schemas/NetworkBatchFile"},"type":"array","title":"Batches"},"total_batch_count":{"type":"integer","title":"Total Batch Count"}},"type":"object","required":["session_id","batches","total_batch_count"],"title":"NetworkLogsResponse"},"NodeSelectors":{"properties":{"css_selector":{"type":"string","title":"Css Selector"},"xpath_selector":{"type":"string","title":"Xpath Selector"},"in_iframe":{"type":"boolean","title":"In Iframe"},"in_shadow_root":{"type":"boolean","title":"In Shadow Root"},"notte_selector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notte Selector"},"iframe_parent_css_selectors":{"items":{"type":"string"},"type":"array","title":"Iframe Parent Css Selectors"},"playwright_selector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playwright Selector"},"python_selector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Python Selector"}},"type":"object","required":["css_selector","xpath_selector","in_iframe","in_shadow_root","iframe_parent_css_selectors"],"title":"NodeSelectors"},"NotteProxy":{"properties":{"type":{"type":"string","const":"notte","title":"Type","default":"notte"},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"country":{"anyOf":[{"$ref":"#/components/schemas/ProxyGeolocationCountry"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"}},"additionalProperties":false,"type":"object","title":"NotteProxy"},"NudgePromptRequest":{"properties":{"task":{"type":"string","title":"Task"},"agent_messages":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Agent Messages"}},"type":"object","required":["task","agent_messages"],"title":"NudgePromptRequest"},"NudgePromptResponse":{"properties":{"prompt":{"type":"string","title":"Prompt"}},"type":"object","required":["prompt"],"title":"NudgePromptResponse"},"Observation":{"properties":{"started_at":{"type":"string","format":"date-time","title":"Started At"},"ended_at":{"type":"string","format":"date-time","title":"Ended At"},"metadata":{"$ref":"#/components/schemas/SnapshotMetadata","description":"Metadata of the current page, i.e url, page title, snapshot timestamp."},"screenshot":{"$ref":"#/components/schemas/Screenshot","description":"Base64 encoded screenshot of the current page"},"space":{"$ref":"#/components/schemas/ActionSpace","description":"Available actions in the current state"}},"type":"object","required":["started_at","ended_at","metadata","screenshot","space"],"title":"Observation"},"ObserveRequest":{"properties":{"min_nb_actions":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Nb Actions","description":"The minimum number of actions to list before stopping. If not provided, the listing will continue until the maximum number of actions is reached."},"max_nb_actions":{"type":"integer","title":"Max Nb Actions","description":"The maximum number of actions to list after which the listing will stop. Used when min_nb_actions is not provided.","default":100},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions","description":"Additional instructions to use for the observation."},"perception_type":{"anyOf":[{"type":"string","enum":["fast","deep"]},{"type":"null"}],"title":"Perception Type","description":"Whether to run with fast or deep perception"}},"additionalProperties":false,"type":"object","title":"ObserveRequest"},"PaginatedResponse_AgentResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AgentResponse"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"has_next":{"type":"boolean","title":"Has Next"},"has_previous":{"type":"boolean","title":"Has Previous","readOnly":true}},"type":"object","required":["items","page","page_size","has_next","has_previous"],"title":"PaginatedResponse[AgentResponse]"},"PaginatedResponse_FunctionListItemResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/FunctionListItemResponse"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"has_next":{"type":"boolean","title":"Has Next"},"has_previous":{"type":"boolean","title":"Has Previous","readOnly":true}},"type":"object","required":["items","page","page_size","has_next","has_previous"],"title":"PaginatedResponse[FunctionListItemResponse]"},"PaginatedResponse_FunctionRunListItemResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/FunctionRunListItemResponse"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"has_next":{"type":"boolean","title":"Has Next"},"has_previous":{"type":"boolean","title":"Has Previous","readOnly":true}},"type":"object","required":["items","page","page_size","has_next","has_previous"],"title":"PaginatedResponse[FunctionRunListItemResponse]"},"PaginatedResponse_PersonaResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/PersonaResponse"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"has_next":{"type":"boolean","title":"Has Next"},"has_previous":{"type":"boolean","title":"Has Previous","readOnly":true}},"type":"object","required":["items","page","page_size","has_next","has_previous"],"title":"PaginatedResponse[PersonaResponse]"},"PaginatedResponse_ProfileResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ProfileResponse"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"has_next":{"type":"boolean","title":"Has Next"},"has_previous":{"type":"boolean","title":"Has Previous","readOnly":true}},"type":"object","required":["items","page","page_size","has_next","has_previous"],"title":"PaginatedResponse[ProfileResponse]"},"PaginatedResponse_SessionResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/SessionResponse"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"has_next":{"type":"boolean","title":"Has Next"},"has_previous":{"type":"boolean","title":"Has Previous","readOnly":true}},"type":"object","required":["items","page","page_size","has_next","has_previous"],"title":"PaginatedResponse[SessionResponse]"},"PaginatedResponse_UsageLog_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/UsageLog"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"has_next":{"type":"boolean","title":"Has Next"},"has_previous":{"type":"boolean","title":"Has Previous","readOnly":true}},"type":"object","required":["items","page","page_size","has_next","has_previous"],"title":"PaginatedResponse[UsageLog]"},"PaginatedResponse_Vault_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/Vault"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"has_next":{"type":"boolean","title":"Has Next"},"has_previous":{"type":"boolean","title":"Has Previous","readOnly":true}},"type":"object","required":["items","page","page_size","has_next","has_previous"],"title":"PaginatedResponse[Vault]"},"ParameterInfo":{"properties":{"name":{"type":"string","title":"Name"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"},"default":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default"}},"type":"object","required":["name"],"title":"ParameterInfo"},"PersonaCreateRequest":{"properties":{"create_vault":{"type":"boolean","title":"Create Vault","description":"Whether to create a vault for the persona","default":false},"create_phone_number":{"type":"boolean","title":"Create Phone Number","description":"Whether to create a phone number for the persona","default":false},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"additionalProperties":false,"type":"object","title":"PersonaCreateRequest"},"PersonaResponse":{"properties":{"persona_id":{"type":"string","title":"Persona Id","description":"ID of the created persona"},"status":{"type":"string","title":"Status","description":"Status of the persona (active, closed)"},"first_name":{"type":"string","title":"First Name","description":"First name of the persona"},"last_name":{"type":"string","title":"Last Name","description":"Last name of the persona"},"email":{"type":"string","title":"Email","description":"Public, human-readable email address of the persona"},"internal_email":{"type":"string","title":"Internal Email","description":"Internal UUID-backed mailbox address of the persona"},"vault_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vault Id","description":"ID of the vault"},"phone_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone Number","description":"Phone number of the persona (optional)"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["persona_id","status","first_name","last_name","email","internal_email","vault_id","phone_number","created_at"],"title":"PersonaResponse"},"PersonaUpdateRequest":{"properties":{"name":{"type":"string","title":"Name"}},"type":"object","required":["name"],"title":"PersonaUpdateRequest"},"PressKeyAction":{"properties":{"type":{"type":"string","const":"press_key","title":"Type","default":"press_key"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Press a keyboard key: e.g. 'Enter', 'Backspace', 'Insert', 'Delete', etc."},"key":{"type":"string","title":"Key"}},"type":"object","required":["key"],"title":"PressKeyAction"},"ProfileCookiesImportRequest":{"properties":{"cookies":{"items":{"$ref":"#/components/schemas/Cookie"},"type":"array","minItems":1,"title":"Cookies"},"source_format":{"type":"string","enum":["playwright","chrome"],"title":"Source Format","default":"playwright"},"mode":{"type":"string","enum":["replace","append"],"title":"Mode","default":"replace"}},"additionalProperties":false,"type":"object","required":["cookies"],"title":"ProfileCookiesImportRequest"},"ProfileCookiesImportResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"cookies_count":{"type":"integer","title":"Cookies Count"},"mode":{"type":"string","enum":["replace","append"],"title":"Mode"}},"type":"object","required":["success","message","cookies_count","mode"],"title":"ProfileCookiesImportResponse"},"ProfileCreateRequest":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Name of the profile"}},"additionalProperties":false,"type":"object","title":"ProfileCreateRequest"},"ProfileDeleteResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"message":{"type":"string","title":"Message","default":"Profile deleted successfully"}},"type":"object","title":"ProfileDeleteResponse"},"ProfileDuplicateRequest":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Optional name for the duplicate; defaults to the source profile name"}},"type":"object","title":"ProfileDuplicateRequest"},"ProfileResponse":{"properties":{"profile_id":{"type":"string","title":"Profile Id","description":"Profile ID (format: notte-profile-{16 hex chars})"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Profile name"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Profile creation timestamp"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"Profile last update timestamp"},"persisted_domains":{"items":{"type":"string"},"type":"array","title":"Persisted Domains","description":"List of domains with persisted browser state (cookies, localStorage, sessionStorage)"}},"type":"object","required":["profile_id","name","created_at","updated_at"],"title":"ProfileResponse"},"ProxyGeolocationCountry":{"type":"string","enum":["ad","ae","af","ag","ai","al","am","ao","ar","at","au","aw","az","ba","bb","bd","be","bf","bg","bh","bi","bj","bm","bn","bo","bq","br","bs","bt","bw","by","bz","ca","cd","cg","ch","ci","cl","cm","cn","co","cr","cu","cv","cw","cy","cz","de","dj","dk","dm","do","dz","ec","ee","eg","es","et","fi","fj","fr","ga","gb","gd","ge","gf","gg","gh","gi","gm","gn","gp","gq","gr","gt","gu","gw","gy","hk","hn","hr","ht","hu","id","ie","il","im","in","iq","ir","is","it","je","jm","jo","jp","ke","kg","kh","kn","kr","kw","ky","kz","la","lb","lc","lk","lr","ls","lt","lu","lv","ly","ma","md","me","mf","mg","mk","ml","mm","mn","mo","mq","mr","mt","mu","mv","mw","mx","my","mz","na","nc","ne","ng","ni","nl","no","np","nz","om","pa","pe","pf","pg","ph","pk","pl","pr","ps","pt","py","qa","re","ro","rs","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sr","ss","st","sv","sx","sy","sz","tc","tg","th","tj","tm","tn","tr","tt","tw","tz","ua","ug","us","uy","uz","vc","ve","vg","vi","vn","ye","za","zm","zw"],"title":"ProxyGeolocationCountry"},"ReloadAction":{"properties":{"type":{"type":"string","const":"reload","title":"Type","default":"reload"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Reload the current page"}},"type":"object","title":"ReloadAction"},"ReplayMissingResponse":{"properties":{"detail":{"type":"string","title":"Detail"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"status":{"type":"integer","title":"Status"},"error":{"type":"string","title":"Error"},"message":{"type":"string","title":"Message"},"replay_status":{"type":"string","enum":["waiting_for_session","processing","unavailable","failed","unknown"],"title":"Replay Status"},"retryable":{"type":"boolean","title":"Retryable"}},"type":"object","required":["detail","session_id","status","error","message","replay_status","retryable"],"title":"ReplayMissingResponse"},"ReplayResponse":{"properties":{"playlist_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playlist Content"},"mp4_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mp4 Url"},"expires_at":{"type":"string","title":"Expires At"},"video_start_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Video Start Ms"},"video_duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Video Duration Ms"}},"type":"object","required":["expires_at"],"title":"ReplayResponse"},"RootModel_Any_":{"title":"RootModel[Any]"},"RunFunctionRequest":{"properties":{"workflow_id":{"type":"string","title":"Workflow Id","description":"The ID of the function to run"},"variables":{"additionalProperties":true,"type":"object","title":"Variables","description":"The variables to run the workflow with"},"runtime":{"anyOf":[{"type":"string","enum":["standard","extended"]},{"type":"null"}],"title":"Runtime","description":"Override the saved function runtime; omit to inherit its default"},"stream":{"type":"boolean","title":"Stream","description":"Whether to stream logs, or only return final response","default":true}},"additionalProperties":false,"type":"object","required":["workflow_id","variables"],"title":"RunFunctionRequest"},"RuntimePackage":{"properties":{"import_name":{"type":"string","title":"Import Name","description":"The name a function writes in its `import` statement, e.g. `notte_sdk`."},"package":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Package","description":"Distribution providing it, e.g. `notte-sdk`. Null when nothing on disk claims the name."},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version","description":"Installed version of `package`, or null if unknown."},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","description":"Installable reference this came from when it did not come from an index, e.g. `git+https://github.com/nottelabs/notte@<sha>#subdirectory=packages/notte-sdk`. Null for an ordinary index install, where `version` is the whole identity. Read from the install's own PEP 610 record: the runner pins notte-sdk and notte-core to git SHAs, so those share a version number with a PyPI build that behaves differently, and reproducing the sandbox from `version` alone gets you the wrong code."},"installed":{"type":"boolean","title":"Installed","description":"False for a name the upload validator accepts but the runtime image does not ship: such an import passes validation and then fails mid-run with ModuleNotFoundError.","default":true}},"type":"object","required":["import_name"],"title":"RuntimePackage"},"SMSResponse":{"properties":{"body":{"type":"string","title":"Body","description":"SMS message body"},"sms_id":{"type":"string","title":"Sms Id","description":"SMS UUID"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation date"},"sender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sender","description":"SMS sender phone number"}},"type":"object","required":["body","sms_id","created_at","sender"],"title":"SMSResponse"},"ScheduleDeleteResponse":{"properties":{"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"ScheduleDeleteResponse"},"ScheduleResponse":{"properties":{"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"ScheduleResponse"},"SchemaGenerationResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"model_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Model Schema"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["success"],"title":"SchemaGenerationResponse"},"ScrapeAction":{"properties":{"type":{"type":"string","const":"scrape","title":"Type","default":"scrape"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Scrape the current page data in text format. If `instructions` is null then the whole page will be scraped. Otherwise, only the data that matches the instructions will be scraped. Instructions should be given as natural language, e.g. 'Extract the title and the price of the product'"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"only_main_content":{"type":"boolean","title":"Only Main Content","description":"Whether to only scrape the main content of the page. If True, navbars, footers, etc. are excluded.","default":true},"selector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selector","description":"Playwright selector to scope the scrape to. Only content inside this selector will be scraped."},"only_images":{"type":"boolean","title":"Only Images","description":"Whether to only scrape images from the page. If True, the page content is excluded.","default":false},"scrape_links":{"type":"boolean","title":"Scrape Links","description":"Whether to scrape links from the page. Links are scraped by default.","default":true},"scrape_images":{"type":"boolean","title":"Scrape Images","description":"Whether to scrape images from the page.","default":false},"ignored_tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ignored Tags","description":"HTML tags to ignore from the page."},"response_format":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Response Format","description":"JSON schema dict for structured output. Agent can provide a schema to extract structured data."}},"type":"object","title":"ScrapeAction"},"ScrapeFromHtmlRequest":{"properties":{"selector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selector","description":"Playwright selector to scope the scrape to. Only content inside this selector will be scraped."},"scrape_links":{"type":"boolean","title":"Scrape Links","description":"Whether to scrape links from the page. Links are scraped by default.","default":true},"scrape_images":{"type":"boolean","title":"Scrape Images","description":"Whether to scrape images from the page. Images are scraped by default.","default":false},"ignored_tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ignored Tags","description":"HTML tags to ignore from the page"},"only_main_content":{"type":"boolean","title":"Only Main Content","description":"Whether to only scrape the main content of the page. If True, navbars, footers, etc. are excluded.","default":false},"only_images":{"type":"boolean","title":"Only Images","description":"Whether to only scrape images from the page. If True, the page content is excluded.","default":false},"response_format":{"anyOf":[{},{"type":"null"}],"title":"Response Format","description":"The response format to use for the scrape. You can use a Pydantic model or a JSON Schema dict (cf. https://docs.pydantic.dev/latest/concepts/json_schema/#generating-json-schema.)"},"instructions":{"type":"string","title":"Instructions","description":"User description as to what needs to be scraped","default":""},"use_link_placeholders":{"type":"boolean","title":"Use Link Placeholders","description":"Whether to use link/image placeholders to reduce the number of tokens in the prompt and hallucinations. However this is an experimental feature and might not work as expected.","default":false},"frames":{"items":{"$ref":"#/components/schemas/FrameData"},"type":"array","title":"Frames","description":"Frame data for all frames found in the page. The main frame has to be the first one"}},"additionalProperties":false,"type":"object","title":"ScrapeFromHtmlRequest"},"ScrapeRequest":{"properties":{"selector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selector","description":"Playwright selector to scope the scrape to. Only content inside this selector will be scraped."},"scrape_links":{"type":"boolean","title":"Scrape Links","description":"Whether to scrape links from the page. Links are scraped by default.","default":true},"scrape_images":{"type":"boolean","title":"Scrape Images","description":"Whether to scrape images from the page. Images are scraped by default.","default":false},"ignored_tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ignored Tags","description":"HTML tags to ignore from the page"},"only_main_content":{"type":"boolean","title":"Only Main Content","description":"Whether to only scrape the main content of the page. If True, navbars, footers, etc. are excluded.","default":false},"only_images":{"type":"boolean","title":"Only Images","description":"Whether to only scrape images from the page. If True, the page content is excluded.","default":false},"response_format":{"anyOf":[{},{"type":"null"}],"title":"Response Format","description":"The response format to use for the scrape. You can use a Pydantic model or a JSON Schema dict (cf. https://docs.pydantic.dev/latest/concepts/json_schema/#generating-json-schema.)"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions","description":"Additional instructions to use for the scrape. E.g. 'Extract only the title, date and content of the articles.'"},"use_link_placeholders":{"type":"boolean","title":"Use Link Placeholders","description":"Whether to use link/image placeholders to reduce the number of tokens in the prompt and hallucinations. However this is an experimental feature and might not work as expected.","default":false}},"additionalProperties":false,"type":"object","title":"ScrapeRequest"},"ScrapeSchemaResponse":{"properties":{"model_schema":{"$ref":"#/components/schemas/SchemaGenerationResponse","description":"Output schema generated by the llm according to the instructions"},"scrape":{"anyOf":[{"$ref":"#/components/schemas/StructuredData_BaseModel_"},{"type":"null"}],"description":"Output from the scrape, validated upon the model schema"}},"type":"object","required":["model_schema","scrape"],"title":"ScrapeSchemaResponse"},"Screenshot":{"properties":{"raw":{"type":"string","contentMediaType":"application/octet-stream","title":"Raw"},"bboxes":{"items":{"$ref":"#/components/schemas/BoundingBox"},"type":"array","title":"Bboxes"},"last_action_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Action Id"}},"type":"object","required":["raw"],"title":"Screenshot"},"ScrollDownAction":{"properties":{"type":{"type":"string","const":"scroll_down","title":"Type","default":"scroll_down"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Scroll down by a given amount of pixels. Use `null` for scrolling down one page"},"amount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount"}},"type":"object","title":"ScrollDownAction"},"ScrollUpAction":{"properties":{"type":{"type":"string","const":"scroll_up","title":"Type","default":"scroll_up"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Scroll up by a given amount of pixels. Use `null` for scrolling up one page"},"amount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount"}},"type":"object","title":"ScrollUpAction"},"SearchRequest":{"properties":{"q":{"type":"string","title":"Q","description":"The search query"},"depth":{"type":"string","title":"Depth","description":"Search depth: 'standard', 'fast', or 'deep'","default":"standard"},"outputType":{"type":"string","title":"Outputtype","description":"Output type: 'searchResults', 'sourcedAnswer', or 'structured'","default":"searchResults"}},"additionalProperties":true,"type":"object","required":["q"],"title":"SearchRequest"},"SecretListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/SecretMetadata"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"SecretListResponse"},"SecretMetadata":{"properties":{"id":{"type":"string","title":"Id"},"namespace":{"$ref":"#/components/schemas/SecretNamespace"},"name":{"type":"string","title":"Name"},"key_hint":{"type":"string","title":"Key Hint"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"}},"type":"object","required":["id","namespace","name","key_hint","created_at"],"title":"SecretMetadata"},"SecretNamespace":{"type":"string","enum":["llm_provider","function_env"],"title":"SecretNamespace"},"SecretStoreRequest":{"properties":{"namespace":{"$ref":"#/components/schemas/SecretNamespace"},"name":{"type":"string","maxLength":128,"minLength":1,"title":"Name"},"value":{"type":"string","minLength":1,"title":"Value"}},"type":"object","required":["namespace","name","value"],"title":"SecretStoreRequest"},"SecretValueResponse":{"properties":{"value":{"type":"string","title":"Value"}},"type":"object","required":["value"],"title":"SecretValueResponse"},"SelectDropdownOptionAction-Input":{"properties":{"type":{"type":"string","const":"select_dropdown_option","title":"Type","default":"select_dropdown_option"},"category":{"type":"string","minLength":1,"title":"Category","default":"Interaction Actions"},"description":{"type":"string","title":"Description","default":"Select an option from a dropdown. The `id` field should be set to the select element's id. Then you can either set the `value` field to the option's text or the `option_id` field to the option's `id`."},"id":{"type":"string","title":"Id","default":""},"selector":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/NodeSelectors"},{"type":"null"}],"title":"Selector"},"press_enter":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Press Enter"},"text_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Label"},"param":{"anyOf":[{"$ref":"#/components/schemas/ActionParameter"},{"type":"null"}],"default":{"name":"value","type":"str","values":[]}},"timeout":{"type":"integer","minimum":0.0,"title":"Timeout","description":"Action timeout in milliseconds","default":15000},"value":{"anyOf":[{"type":"string"},{"type":"string","format":"password","writeOnly":true}],"title":"Value"}},"type":"object","required":["value"],"title":"SelectDropdownOptionAction"},"SelectDropdownOptionAction-Output":{"properties":{"type":{"type":"string","const":"select_dropdown_option","title":"Type","default":"select_dropdown_option"},"category":{"type":"string","minLength":1,"title":"Category","default":"Interaction Actions"},"description":{"type":"string","title":"Description","default":"Select an option from a dropdown. The `id` field should be set to the select element's id. Then you can either set the `value` field to the option's text or the `option_id` field to the option's `id`."},"id":{"type":"string","title":"Id","default":""},"selector":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/NodeSelectors"},{"type":"null"}],"title":"Selector"},"press_enter":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Press Enter"},"text_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Label"},"timeout":{"type":"integer","minimum":0.0,"title":"Timeout","description":"Action timeout in milliseconds","default":15000},"value":{"anyOf":[{"type":"string"},{"type":"string","format":"password","writeOnly":true}],"title":"Value"}},"type":"object","required":["value"],"title":"SelectDropdownOptionAction"},"SerializedError":{"properties":{"error_type":{"type":"string","title":"Error Type"},"dev_message":{"type":"string","title":"Dev Message"},"user_message":{"type":"string","title":"User Message"},"agent_message":{"type":"string","title":"Agent Message"},"should_retry_later":{"type":"boolean","title":"Should Retry Later","default":false},"should_notify_team":{"type":"boolean","title":"Should Notify Team","default":false}},"type":"object","required":["error_type","dev_message","user_message","agent_message"],"title":"SerializedError"},"SessionDebugResponse":{"properties":{"debug_url":{"type":"string","title":"Debug Url"},"ws":{"$ref":"#/components/schemas/WebSocketUrls"},"tabs":{"items":{"$ref":"#/components/schemas/TabSessionDebugResponse"},"type":"array","title":"Tabs"}},"type":"object","required":["debug_url","ws","tabs"],"title":"SessionDebugResponse"},"SessionFile":{"properties":{"id":{"type":"string","title":"Id"},"session_id":{"type":"string","title":"Session Id"},"filename":{"type":"string","title":"Filename"},"mime_type":{"type":"string","title":"Mime Type"},"size":{"type":"integer","title":"Size"},"checksum":{"type":"string","title":"Checksum"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"source":{"$ref":"#/components/schemas/FileSource"}},"type":"object","required":["id","session_id","filename","mime_type","size","checksum","created_at","expires_at","source"],"title":"SessionFile"},"SessionFilesPage":{"properties":{"files":{"items":{"$ref":"#/components/schemas/SessionFile"},"type":"array","title":"Files"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["files","total","limit","offset"],"title":"SessionFilesPage"},"SessionOffsetResponse":{"properties":{"offset":{"type":"integer","title":"Offset","description":"Current state of the session trajectory"}},"type":"object","required":["offset"],"title":"SessionOffsetResponse"},"SessionProfile":{"properties":{"id":{"type":"string","title":"Id","description":"Profile ID to use for this session"},"persist":{"type":"boolean","title":"Persist","description":"Whether to save browser state to profile on session close","default":false}},"additionalProperties":false,"type":"object","required":["id"],"title":"SessionProfile"},"SessionResponse":{"properties":{"session_id":{"type":"string","title":"Session Id","description":"The ID of the session (created or existing). Use this ID to interact with the session for the next operation."},"idle_timeout_minutes":{"type":"integer","title":"Idle Timeout Minutes","description":"Session idle timeout in minutes. Will timeout if now() > last access time + idle_timeout_minutes"},"max_duration_minutes":{"type":"integer","title":"Max Duration Minutes","description":"Session max duration in minutes. Will timeout if now() > creation time + max_duration_minutes","default":15},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Session creation time"},"closed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Closed At","description":"Session closing time"},"last_accessed_at":{"type":"string","format":"date-time","title":"Last Accessed At","description":"Last access time"},"duration":{"type":"string","title":"Duration","description":"Session duration"},"status":{"type":"string","enum":["active","closed","error","timed_out"],"title":"Status","description":"Session status"},"close_reason":{"anyOf":[{"type":"string","enum":["manual","idle_timeout","max_duration","error","unknown"]},{"type":"null"}],"title":"Close Reason","description":"Reason the session closed, if it is no longer active"},"steps":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Steps","description":"Steps of the session"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message if the operation failed to complete"},"proxies":{"type":"boolean","title":"Proxies","description":"Whether proxies were used for the session. True if any proxy was applied during session creation.","default":false},"browser_type":{"type":"string","enum":["chromium","chrome","firefox","chrome-nightly","chrome-turbo"],"title":"Browser Type","default":"chromium"},"network_request_bytes":{"type":"integer","title":"Network Request Bytes","description":"Total byte usage for network requests.","default":0},"network_response_bytes":{"type":"integer","title":"Network Response Bytes","description":"Total byte usage for network responses.","default":0},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent","description":"The user agent to use for the session"},"viewport_width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Viewport Width","description":"The width of the viewport"},"viewport_height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Viewport Height","description":"The height of the viewport"},"solve_captchas":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Solve Captchas","description":"Whether to solve captchas."},"cdp_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cdp Url","description":"The URL to connect to the CDP server."},"viewer_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Viewer Url","description":"The remote session viewer URL."},"web_bot_auth":{"type":"boolean","title":"Web Bot Auth","description":"Whether to use web bot authentication.","default":false},"auth_ids":{"items":{"type":"string"},"type":"array","title":"Auth Ids","description":"Managed Auth connection IDs attached to this session.","default":[]},"system_hidden":{"type":"boolean","title":"System Hidden","description":"Whether this session is an internal system run. Internal system runs are omitted from session.list() unless include_system=True is requested.","default":false},"timeout_minutes":{"type":"integer","title":"Timeout Minutes","deprecated":true,"readOnly":true}},"additionalProperties":true,"type":"object","required":["session_id","idle_timeout_minutes","created_at","last_accessed_at","status","timeout_minutes"],"title":"SessionResponse"},"SmsReadAction":{"properties":{"type":{"type":"string","const":"sms_read","title":"Type","default":"sms_read"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Read sms messages received recently."},"limit":{"type":"integer","title":"Limit","description":"Max number of sms to return","default":10},"timedelta":{"anyOf":[{"type":"string","format":"duration"},{"type":"null"}],"title":"Timedelta","description":"Return only sms that are not older than `timedelta`","default":"PT5M"},"only_unread":{"type":"boolean","title":"Only Unread","description":"Return only previously unread sms","default":true}},"type":"object","title":"SmsReadAction"},"SnapshotMetadata":{"properties":{"title":{"type":"string","title":"Title"},"url":{"type":"string","title":"Url"},"viewport":{"$ref":"#/components/schemas/ViewportData"},"tabs":{"items":{"$ref":"#/components/schemas/TabsData"},"type":"array","title":"Tabs"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"Timestamp of the snapshot"}},"type":"object","required":["title","url","viewport","tabs"],"title":"SnapshotMetadata"},"SpaceCategory":{"type":"string","enum":["homepage","search-results","data-feed","item","auth","form","manage-cookies","overlay","payment","captcha","other"],"title":"SpaceCategory"},"StructuredData_BaseModel_":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the data was extracted successfully","default":true},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message if the data was not extracted successfully"},"data":{"anyOf":[{"$ref":"#/components/schemas/BaseModel"},{"$ref":"#/components/schemas/RootModel_Any_"},{"type":"null"}],"title":"Data","description":"Structured data extracted from the page in JSON format"}},"type":"object","title":"StructuredData[BaseModel]"},"SubscriptionType":{"type":"string","enum":["free","pro","growth","playground","admin","minoan","proofs","interview"],"title":"SubscriptionType"},"SwitchTabAction":{"properties":{"type":{"type":"string","const":"switch_tab","title":"Type","default":"switch_tab"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Switch to a tab (identified by its index)"},"tab_index":{"type":"integer","title":"Tab Index"}},"type":"object","required":["tab_index"],"title":"SwitchTabAction"},"TabSessionDebugResponse":{"properties":{"metadata":{"$ref":"#/components/schemas/TabsData"},"debug_url":{"type":"string","title":"Debug Url"},"ws_url":{"type":"string","title":"Ws Url"}},"type":"object","required":["metadata","debug_url","ws_url"],"title":"TabSessionDebugResponse"},"TabsData":{"properties":{"tab_id":{"type":"integer","title":"Tab Id"},"title":{"type":"string","title":"Title"},"url":{"type":"string","title":"Url"}},"type":"object","required":["tab_id","title","url"],"title":"TabsData"},"TailnetProxy":{"properties":{"type":{"type":"string","const":"tailnet","title":"Type","default":"tailnet"},"oauth_client_id":{"type":"string","title":"Oauth Client Id"},"oauth_client_secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Oauth Client Secret"}},"additionalProperties":false,"type":"object","required":["oauth_client_id"],"title":"TailnetProxy"},"UpdateFunctionRunResponse":{"properties":{"function_id":{"type":"string","title":"Function Id","description":"The ID of the function"},"function_run_id":{"type":"string","title":"Function Run Id","description":"The ID of the function run"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"status":{"type":"string","enum":["updated","stopped"],"title":"Status","default":"updated"},"workflow_id":{"type":"string","title":"Workflow Id","readOnly":true},"workflow_run_id":{"type":"string","title":"Workflow Run Id","readOnly":true}},"type":"object","required":["function_id","function_run_id","updated_at","workflow_id","workflow_run_id"],"title":"UpdateFunctionRunResponse"},"UploadFileAction-Input":{"properties":{"type":{"type":"string","const":"upload_file","title":"Type","default":"upload_file"},"category":{"type":"string","minLength":1,"title":"Category","default":"Interaction Actions"},"description":{"type":"string","title":"Description","default":"Upload file to interactive element with file path. Use with any upload file element, including button, input, a, span, div. CRITICAL: Use only this for file upload, do not use click."},"id":{"type":"string","title":"Id","default":""},"selector":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/NodeSelectors"},{"type":"null"}],"title":"Selector"},"press_enter":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Press Enter"},"text_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Label"},"param":{"anyOf":[{"$ref":"#/components/schemas/ActionParameter"},{"type":"null"}],"default":{"name":"file_path","type":"str","values":[]}},"timeout":{"type":"integer","minimum":0.0,"title":"Timeout","description":"Action timeout in milliseconds","default":15000},"file_path":{"type":"string","title":"File Path"}},"type":"object","required":["file_path"],"title":"UploadFileAction"},"UploadFileAction-Output":{"properties":{"type":{"type":"string","const":"upload_file","title":"Type","default":"upload_file"},"category":{"type":"string","minLength":1,"title":"Category","default":"Interaction Actions"},"description":{"type":"string","title":"Description","default":"Upload file to interactive element with file path. Use with any upload file element, including button, input, a, span, div. CRITICAL: Use only this for file upload, do not use click."},"id":{"type":"string","title":"Id","default":""},"selector":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/NodeSelectors"},{"type":"null"}],"title":"Selector"},"press_enter":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Press Enter"},"text_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Label"},"timeout":{"type":"integer","minimum":0.0,"title":"Timeout","description":"Action timeout in milliseconds","default":15000},"file_path":{"type":"string","title":"File Path"}},"type":"object","required":["file_path"],"title":"UploadFileAction"},"UsageLog":{"properties":{"created_at":{"type":"string","format":"date-time","title":"Created At"},"duration_ms":{"type":"integer","title":"Duration Ms"},"endpoint":{"type":"string","title":"Endpoint"}},"type":"object","required":["created_at","duration_ms","endpoint"],"title":"UsageLog"},"UsageResponse":{"properties":{"plan_type":{"anyOf":[{"$ref":"#/components/schemas/SubscriptionType"},{"type":"string"}],"title":"Plan Type"},"period":{"type":"string","title":"Period"},"session_count":{"type":"integer","title":"Session Count"},"function_count":{"type":"integer","title":"Function Count"},"browser_usage_cost":{"type":"number","title":"Browser Usage Cost"},"proxy_usage_cost":{"type":"number","title":"Proxy Usage Cost"},"llm_usage_cost":{"type":"number","title":"Llm Usage Cost"},"function_usage_cost":{"type":"number","title":"Function Usage Cost"},"total_cost":{"type":"number","title":"Total Cost"},"subscription_limit_amount":{"type":"number","title":"Subscription Limit Amount"},"topup_limit_amount":{"type":"number","title":"Topup Limit Amount"},"subscription_balance_amount":{"type":"number","title":"Subscription Balance Amount"},"topup_balance_amount":{"type":"number","title":"Topup Balance Amount"},"balance_amount":{"type":"number","title":"Balance Amount"},"is_usage_limit_exceeded":{"type":"boolean","title":"Is Usage Limit Exceeded"}},"type":"object","required":["plan_type","period","session_count","function_count","browser_usage_cost","proxy_usage_cost","llm_usage_cost","function_usage_cost","total_cost","subscription_limit_amount","topup_limit_amount","subscription_balance_amount","topup_balance_amount","balance_amount","is_usage_limit_exceeded"],"title":"UsageResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"Vault":{"properties":{"name":{"type":"string","title":"Name"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"vault_id":{"type":"string","title":"Vault Id"},"for_persona":{"type":"boolean","title":"For Persona","default":false}},"type":"object","required":["name","created_at","vault_id"],"title":"Vault"},"VaultCreateRequest":{"properties":{"name":{"type":"string","title":"Name","description":"Name of the vault","default":"default"}},"additionalProperties":false,"type":"object","title":"VaultCreateRequest"},"VaultUpdateRequest":{"properties":{"name":{"type":"string","title":"Name"}},"type":"object","required":["name"],"title":"VaultUpdateRequest"},"ViewportData":{"properties":{"scroll_x":{"type":"integer","title":"Scroll X"},"scroll_y":{"type":"integer","title":"Scroll Y"},"viewport_width":{"type":"integer","title":"Viewport Width"},"viewport_height":{"type":"integer","title":"Viewport Height"},"total_width":{"type":"integer","title":"Total Width"},"total_height":{"type":"integer","title":"Total Height"}},"type":"object","required":["scroll_x","scroll_y","viewport_width","viewport_height","total_width","total_height"],"title":"ViewportData"},"WaitAction":{"properties":{"type":{"type":"string","const":"wait","title":"Type","default":"wait"},"category":{"type":"string","title":"Category","default":"Special Browser Actions"},"description":{"type":"string","title":"Description","default":"Wait for a given amount of time (in milliseconds)"},"time_ms":{"type":"integer","maximum":30000.0,"minimum":0.0,"title":"Time Ms","description":"The amount of time to wait in milliseconds (max 30 seconds)"}},"type":"object","required":["time_ms"],"title":"WaitAction"},"WebSocketUrls":{"properties":{"cdp":{"type":"string","title":"Cdp","description":"WebSocket URL to connect using CDP protocol"},"recording":{"type":"string","title":"Recording","description":"WebSocket URL for live session recording (screenshot stream)"},"logs":{"type":"string","title":"Logs","description":"WebSocket URL for live logs (obsveration / actions events)"}},"additionalProperties":false,"type":"object","required":["cdp","recording","logs"],"title":"WebSocketUrls"}},"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"token"}}}}},"tags":[{"name":"agents","description":"Web AI agents (start, stop, status, replay, etc.)"},{"name":"sessions","description":"Session management (start, stop, status, etc.)"},{"name":"debug","description":"Session debugging tools (replay,logs, recording, etc.)"},{"name":"page","description":"Page operations withing a session (observe, step, scrape, etc.)"},{"name":"storage","description":"File storage interface (upload, download, list, etc.)"},{"name":"network","description":"Network requests/responses withing a session (intercept, etc.)"},{"name":"vaults","description":"Vault & Credentials management (create/delete vaults, create/delete credentials, etc.)"},{"name":"personas","description":"Persona management (create, delete, list emails, list sms, etc.)"},{"name":"scrape","description":"Webpage scraping (scrape, screenshot, etc.) with automatic session management."},{"name":"health","description":"Health check endpoint."},{"name":"usage","description":"Usage logs (usage, logs, etc.)"},{"name":"functions","description":"Functions management (create, delete, list, etc.)"}]}