---
title: "Perform Web Task"
method: POST
path: "/v1/tools/perform-web-task"
tags: ["AI Tools"]
---

# Perform Web Task

`POST /v1/tools/perform-web-task`

Start from a URL and perform the given task.

## Query parameters

- `sessionId` string

## Request body

- PerformWebTaskRequestSchema
  - `url` string — The URL of the webpage. If not provided, the tool will use the current page in the session.
  - `prompt` string, required — The task to be autonomously completed.
  - `agent` 'browser-use' | 'openai-cua' — The AI agent to use for task completion. Defaults to browser-use.
  - `provider` 'openai' | 'gemini' | 'groq' | 'azure' | 'xai' — The AI provider to use for task completion.
  - `model` string — The specific model to use for task completion. see our [models](/agentic-browser-control/ai-task-completion#available-models) page for more information.
  - `highlight_elements` boolean — Whether to highlight elements during task execution for better visibility.
  - `output_schema` object — JSON Schema defining the expected structure of the output data.

## Response `200`

The result of the autonomous task.

- PerformWebTaskResponseSchema
  - `data` object
    - `result` string — The outcome or answer produced by the autonomous task.

## Other responses

- `400` — Invalid request.
- `500` — Internal server error.

## Changes

- **2025-10-16** `b7fe7610c0ce` — 1 info
  - the `agent` request property default value `browser-use` was removed

[Change history](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/changes/v1/tools/perform-web-task/post.md)

---

[API](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api.md) · [All operations](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/anchorbrowser/anchorbrowser-api/revisions/2df5d57062c5/schema)