Skip to content
This repository was archived by the owner on Feb 25, 2026. It is now read-only.

Latest commit

 

History

History
3632 lines (2496 loc) · 42.4 KB

reference.md

File metadata and controls

3632 lines (2496 loc) · 42.4 KB

Reference

Billing

client.billing.get_account_billing()

📝 Description

Get authenticated account information including credit balance and account details.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.billing.get_account_billing()

⚙️ Parameters

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

Tasks

client.tasks.list_tasks(...)

📝 Description

Get paginated list of AI agent tasks with optional filtering by session and status.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.tasks.list_tasks()

⚙️ Parameters

page_size: typing.Optional[int]

page_number: typing.Optional[int]

session_id: typing.Optional[str]

filter_by: typing.Optional[TaskStatus]

after: typing.Optional[dt.datetime]

before: typing.Optional[dt.datetime]

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.tasks.create_task(...)

📝 Description

Create and start a new task.

You can either:

  1. Start a new task without a sessionId (auto-creates a session with US proxy by default). Note: Tasks without a sessionId are one-off tasks that automatically close the session upon completion (keep_alive=false).
  2. Start a new task in an existing session (reuse for follow-up tasks or custom configuration)

Important: Proxy configuration (proxyCountryCode) and other session settings (like keep_alive) are session-level settings, not task-level settings. For full control over session configuration, create a session first via POST /sessions with your desired settings, then pass that sessionId when creating tasks.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.tasks.create_task(
    task="task",
)

⚙️ Parameters

task: str — The task prompt/instruction for the agent.

llm: typing.Optional[SupportedLlMs] — The LLM model to use for the agent.

start_url: typing.Optional[str] — The URL to start the task from.

max_steps: typing.Optional[int] — Maximum number of steps the agent can take before stopping.

structured_output: typing.Optional[str] — The stringified JSON schema for the structured output.

session_id: typing.Optional[str] — The ID of the session where the task will run.

metadata: typing.Optional[typing.Dict[str, typing.Optional[str]]] — The metadata for the task. Up to 10 key-value pairs.

secrets: typing.Optional[typing.Dict[str, typing.Optional[str]]] — The secrets for the task. Allowed domains are not required for secrets to be injected, but are recommended.

allowed_domains: typing.Optional[typing.Sequence[str]] — The allowed domains for the task.

op_vault_id: typing.Optional[str] — The ID of the 1Password vault to use for the task. This is used to inject secrets into the task.

highlight_elements: typing.Optional[bool] — Tells the agent to highlight interactive elements on the page.

flash_mode: typing.Optional[bool] — Whether agent flash mode is enabled.

thinking: typing.Optional[bool] — Whether agent thinking mode is enabled.

vision: typing.Optional[CreateTaskRequestVision] — Whether agent vision capabilities are enabled. Set to 'auto' to let the agent decide based on the model capabilities.

system_prompt_extension: typing.Optional[str] — Optional extension to the agent system prompt.

judge: typing.Optional[bool] — Enable judge mode to evaluate task completion against ground truth.

judge_ground_truth: typing.Optional[str] — Expected answer for judge evaluation.

judge_llm: typing.Optional[SupportedLlMs] — The LLM model to use for judging. If not provided, uses the default judge LLM.

skill_ids: typing.Optional[typing.Sequence[str]] — List of skill IDs to enable for this task. Use ['*'] to enable all available skills for the project.

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.tasks.get_task(...)

📝 Description

Get detailed task information including status, progress, steps, and file outputs.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.tasks.get_task(
    task_id="task_id",
)

⚙️ Parameters

task_id: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.tasks.update_task(...)

📝 Description

Control task execution with stop, pause, resume, or stop task and session actions.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.tasks.update_task(
    task_id="task_id",
    action="stop",
)

⚙️ Parameters

task_id: str

action: TaskUpdateAction — The action to perform on the task

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.tasks.get_task_status(...)

📝 Description

Lightweight endpoint optimized for polling task status.

Returns only the task status, output, and cost without loading steps, files, or session details. Use this endpoint for efficient polling instead of GET /tasks/{task_id}.

Recommended polling pattern:

  1. POST /tasks to create a task
  2. Poll GET /tasks/{task_id}/status until status is 'finished' or 'stopped'
  3. GET /tasks/{task_id} once at the end for full details including steps

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.tasks.get_task_status(
    task_id="task_id",
)

⚙️ Parameters

task_id: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.tasks.get_task_logs(...)

📝 Description

Get secure download URL for task execution logs with step-by-step details.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.tasks.get_task_logs(
    task_id="task_id",
)

⚙️ Parameters

task_id: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

Sessions

client.sessions.list_sessions(...)

📝 Description

Get paginated list of AI agent sessions with optional status filtering.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.sessions.list_sessions()

⚙️ Parameters

page_size: typing.Optional[int]

page_number: typing.Optional[int]

filter_by: typing.Optional[SessionStatus]

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.sessions.create_session(...)

📝 Description

Create a new session with a new task.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.sessions.create_session()

⚙️ Parameters

profile_id: typing.Optional[str] — The ID of the profile to use for the session

proxy_country_code: typing.Optional[ProxyCountryCode] — Country code for proxy location.

start_url: typing.Optional[str] — URL to navigate to when the session starts.

browser_screen_width: typing.Optional[int] — Custom screen width in pixels for the browser.

browser_screen_height: typing.Optional[int] — Custom screen height in pixels for the browser.

persist_memory: typing.Optional[bool] — If True (default), tasks in this session share memory and history with each other, allowing follow-up tasks to continue from previous context. If False, each task runs as a standalone task without any previous task context.

keep_alive: typing.Optional[bool] — If True (default), the browser session stays alive after tasks complete, allowing follow-up tasks. If False, the session is closed immediately after task completion. Set to False for simple one-off tasks to reduce session idle time.

custom_proxy: typing.Optional[CustomProxy] — Custom proxy settings to use for the session. If not provided, our proxies will be used. Custom proxies are only available for Business and Scaleup subscribers.

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.sessions.get_session(...)

📝 Description

Get detailed session information including status, URLs, and task details.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.sessions.get_session(
    session_id="session_id",
)

⚙️ Parameters

session_id: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.sessions.delete_session(...)

📝 Description

Delete a session with all its tasks.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.sessions.delete_session(
    session_id="session_id",
)

⚙️ Parameters

session_id: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.sessions.update_session(...)

📝 Description

Stop a session and all its running tasks.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.sessions.update_session(
    session_id="session_id",
    action="stop",
)

⚙️ Parameters

session_id: str

action: SessionUpdateAction — The action to perform on the session

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.sessions.get_session_public_share(...)

📝 Description

Get public share information including URL and usage statistics.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.sessions.get_session_public_share(
    session_id="session_id",
)

⚙️ Parameters

session_id: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.sessions.create_session_public_share(...)

📝 Description

Create or return existing public share for a session.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.sessions.create_session_public_share(
    session_id="session_id",
)

⚙️ Parameters

session_id: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.sessions.delete_session_public_share(...)

📝 Description

Remove public share for a session.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.sessions.delete_session_public_share(
    session_id="session_id",
)

⚙️ Parameters

session_id: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

Files

client.files.agent_session_upload_file_presigned_url(...)

📝 Description

Generate a secure presigned URL for uploading files to an agent session.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.files.agent_session_upload_file_presigned_url(
    session_id="session_id",
    file_name="fileName",
    content_type="image/jpg",
    size_bytes=1,
)

⚙️ Parameters

session_id: str

file_name: str — The name of the file to upload

content_type: UploadFileRequestContentType — The content type of the file to upload

size_bytes: int

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.files.browser_session_upload_file_presigned_url(...)

📝 Description

Generate a secure presigned URL for uploading files to a browser session.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.files.browser_session_upload_file_presigned_url(
    session_id="session_id",
    file_name="fileName",
    content_type="image/jpg",
    size_bytes=1,
)

⚙️ Parameters

session_id: str

file_name: str — The name of the file to upload

content_type: UploadFileRequestContentType — The content type of the file to upload

size_bytes: int

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.files.get_task_output_file_presigned_url(...)

📝 Description

Get secure download URL for an output file generated by the AI agent.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.files.get_task_output_file_presigned_url(
    task_id="task_id",
    file_id="file_id",
)

⚙️ Parameters

task_id: str

file_id: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

Profiles

client.profiles.list_profiles(...)

📝 Description

Get paginated list of profiles.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.profiles.list_profiles()

⚙️ Parameters

page_size: typing.Optional[int]

page_number: typing.Optional[int]

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.profiles.create_profile(...)

📝 Description

Profiles allow you to preserve the state of the browser between tasks.

They are most commonly used to allow users to preserve the log-in state in the agent between tasks. You'd normally create one profile per user and then use it for all their tasks.

You can create a new profile by calling this endpoint.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.profiles.create_profile()

⚙️ Parameters

name: typing.Optional[str] — Optional name for the profile

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.profiles.get_profile(...)

📝 Description

Get profile details.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.profiles.get_profile(
    profile_id="profile_id",
)

⚙️ Parameters

profile_id: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.profiles.delete_browser_profile(...)

📝 Description

Permanently delete a browser profile and its configuration.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.profiles.delete_browser_profile(
    profile_id="profile_id",
)

⚙️ Parameters

profile_id: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.profiles.update_profile(...)

📝 Description

Update a browser profile's information.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.profiles.update_profile(
    profile_id="profile_id",
)

⚙️ Parameters

profile_id: str

name: typing.Optional[str] — Optional name for the profile

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

Browsers

client.browsers.list_browser_sessions(...)

📝 Description

Get paginated list of browser sessions with optional status filtering.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.browsers.list_browser_sessions()

⚙️ Parameters

page_size: typing.Optional[int]

page_number: typing.Optional[int]

filter_by: typing.Optional[BrowserSessionStatus]

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.browsers.create_browser_session(...)

📝 Description

Create a new browser session.

Pricing: Browser sessions are charged per hour with tiered pricing:

  • Pay As You Go users: $0.06/hour
  • Business/Scaleup subscribers: $0.03/hour (50% discount)

The full rate is charged upfront when the session starts. When you stop the session, any unused time is automatically refunded proportionally.

Billing is rounded up to the minute (minimum 1 minute). For example, if you stop a session after 30 minutes, you'll be refunded half the charged amount.

Session Limits:

  • All users: Up to 4 hours per session

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.browsers.create_browser_session()

⚙️ Parameters

profile_id: typing.Optional[str] — The ID of the profile to use for the session

proxy_country_code: typing.Optional[ProxyCountryCode] — Country code for proxy location.

timeout: typing.Optional[int] — The timeout for the session in minutes. All users can use up to 240 minutes (4 hours). Pay As You Go users are charged $0.06/hour, subscribers get 50% off.

browser_screen_width: typing.Optional[int] — Custom screen width in pixels for the browser.

browser_screen_height: typing.Optional[int] — Custom screen height in pixels for the browser.

allow_resizing: typing.Optional[bool] — Whether to allow the browser to be resized during the session (not recommended since it reduces stealthiness).

custom_proxy: typing.Optional[CustomProxy] — Custom proxy settings to use for the session. If not provided, our proxies will be used. Custom proxies are only available for Business and Scaleup subscribers.

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.browsers.get_browser_session(...)

📝 Description

Get detailed browser session information including status and URLs.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.browsers.get_browser_session(
    session_id="session_id",
)

⚙️ Parameters

session_id: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.browsers.update_browser_session(...)

📝 Description

Stop a browser session.

Refund: When you stop a session, unused time is automatically refunded. If the session ran for less than 1 hour, you'll receive a proportional refund. Billing is ceil to the nearest minute (minimum 1 minute).

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.browsers.update_browser_session(
    session_id="session_id",
    action="stop",
)

⚙️ Parameters

session_id: str

action: BrowserSessionUpdateAction — The action to perform on the session

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

Skills

client.skills.list_skills(...)

📝 Description

List all skills owned by the authenticated project with optional filtering.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.skills.list_skills()

⚙️ Parameters

page_size: typing.Optional[int]

page_number: typing.Optional[int]

is_public: typing.Optional[bool]

is_enabled: typing.Optional[bool]

category: typing.Optional[SkillCategory]

query: typing.Optional[str]

from_date: typing.Optional[dt.datetime]

to_date: typing.Optional[dt.datetime]

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.skills.create_skill(...)

📝 Description

Create a new skill via automated generation.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.skills.create_skill(
    goal="goal",
    agent_prompt="agentPrompt",
)

⚙️ Parameters

goal: str — Goal of the skill (description of what the skill does and what the user should expect from it)

agent_prompt: str — Prompt for the agent to use when generating the skill automatically

title: typing.Optional[str] — Optional title for the skill (will be generated if not provided)

description: typing.Optional[str] — Optional description for the skill (will be generated if not provided)

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.skills.get_skill(...)

📝 Description

Get details of a specific skill owned by the project.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.skills.get_skill(
    skill_id="skill_id",
)

⚙️ Parameters

skill_id: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.skills.delete_skill(...)

📝 Description

Delete a skill owned by the project.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.skills.delete_skill(
    skill_id="skill_id",
)

⚙️ Parameters

skill_id: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.skills.update_skill(...)

📝 Description

Update skill metadata (name, description, enabled, etc.).

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.skills.update_skill(
    skill_id="skill_id",
)

⚙️ Parameters

skill_id: str

title: typing.Optional[str] — Display name for the skill (shows up in the public view)

description: typing.Optional[str] — Description of what the skill does (shows up in the public view)

categories: typing.Optional[typing.Sequence[SkillCategory]] — Categories to assign to the skill

domains: typing.Optional[typing.Sequence[str]] — Domains/websites this skill interacts with

is_enabled: typing.Optional[bool] — Whether the skill is enabled for execution

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.skills.cancel_generation(...)

📝 Description

Cancel the current in-progress generation for a skill.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.skills.cancel_generation(
    skill_id="skill_id",
)

⚙️ Parameters

skill_id: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.skills.rollback_skill(...)

📝 Description

Rollback to the previous version (cannot be undone).

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.skills.rollback_skill(
    skill_id="skill_id",
)

⚙️ Parameters

skill_id: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.skills.execute_skill(...)

📝 Description

Execute a skill with the provided parameters.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.skills.execute_skill(
    skill_id="skill_id",
)

⚙️ Parameters

skill_id: str

parameters: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] — Parameters to pass to the skill handler

session_id: typing.Optional[str] — Optional session ID (UUID) for IP persistence.

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.skills.refine_skill(...)

📝 Description

Refine a skill based on feedback.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.skills.refine_skill(
    skill_id="skill_id",
    feedback="feedback",
)

⚙️ Parameters

skill_id: str

feedback: str — Feedback describing what to improve

test_output: typing.Optional[str] — Last skill test output to include in refinement context

test_logs: typing.Optional[str] — Last skill test logs to include in refinement context

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.skills.list_skill_executions(...)

📝 Description

List executions for a specific skill.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.skills.list_skill_executions(
    skill_id="skill_id",
)

⚙️ Parameters

skill_id: str

page_size: typing.Optional[int]

page_number: typing.Optional[int]

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.skills.get_skill_execution_output(...)

📝 Description

Get presigned URL for downloading skill execution output.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.skills.get_skill_execution_output(
    skill_id="skill_id",
    execution_id="execution_id",
)

⚙️ Parameters

skill_id: str

execution_id: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

SkillsMarketplace

client.skills_marketplace.list_skills(...)

📝 Description

List all public skills available in the marketplace with optional filtering.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.skills_marketplace.list_skills()

⚙️ Parameters

page_size: typing.Optional[int]

page_number: typing.Optional[int]

query: typing.Optional[str]

category: typing.Optional[SkillCategory]

from_date: typing.Optional[dt.datetime]

to_date: typing.Optional[dt.datetime]

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.skills_marketplace.get_skill(...)

📝 Description

Get details of a specific public skill from the marketplace.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.skills_marketplace.get_skill(
    skill_slug="skill_slug",
)

⚙️ Parameters

skill_slug: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.skills_marketplace.clone_skill(...)

📝 Description

Clone a public marketplace skill to the user's project.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.skills_marketplace.clone_skill(
    skill_id="skill_id",
)

⚙️ Parameters

skill_id: str

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

client.skills_marketplace.execute_skill(...)

📝 Description

Execute a skill with the provided parameters.

🔌 Usage

from browser_use_sdk import BrowserUse

client = BrowserUse(
    api_key="YOUR_API_KEY",
)
client.skills_marketplace.execute_skill(
    skill_id="skill_id",
)

⚙️ Parameters

skill_id: str

parameters: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] — Parameters to pass to the skill handler

session_id: typing.Optional[str] — Optional session ID (UUID) for IP persistence.

request_options: typing.Optional[RequestOptions] — Request-specific configuration.