Update Task

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

task_idstringRequiredformat: "uuid"

This endpoint expects an object.

actionenumRequired

The action to perform on the task

Allowed values:

Successful Response

idstringformat: "uuid"

Unique identifier for the task

sessionIdstringformat: "uuid"

llmstring

The LLM model used for this task represented as a string

taskstring

The task prompt/instruction given to the agent

statusenum

Current status of the task execution

Allowed values:

startedAtstringformat: "date-time"

Naive UTC timestamp when the task was started

isScheduledboolean

Whether this task was created as a scheduled task

stepslist of objects

outputFileslist of objects

finishedAtstring or nullformat: "date-time"

Naive UTC timestamp when the task completed (None if still running)

metadatamap from strings to any or null

Optional additional metadata associated with the task set by the user

outputstring or null

Final output/result of the task

browserUseVersionstring or null

Version of browser-use used for this task (older tasks may not have this set)

isSuccessboolean or null

Whether the task was successful (self-reported by the agent)

1	curl -X PATCH https://api.browser-use.com/api/v2/tasks/task_id \
2	-H "X-Browser-Use-API-Key: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"action": "stop"
6	}'

1	{
2	"id": "string",
3	"sessionId": "string",
4	"llm": "string",
5	"task": "string",
6	"status": "started",
7	"startedAt": "2024-01-15T09:30:00Z",
8	"isScheduled": true,
9	"steps": [
10	{
11	"number": 1,
12	"memory": "string",
13	"evaluationPreviousGoal": "string",
14	"nextGoal": "string",
15	"url": "string",
16	"actions": [
17	"string"
18	],
19	"screenshotUrl": "string"
20	}
21	],
22	"outputFiles": [
23	{
24	"id": "string",
25	"fileName": "string"
26	}
27	],
28	"finishedAt": "2024-01-15T09:30:00Z",
29	"metadata": {},
30	"output": "string",
31	"browserUseVersion": "string",
32	"isSuccess": true
33	}