Skip to main content
POST
Stop Browser Use Run

Authorizations

X-Browser-Use-API-Key
string
header
required

Path Parameters

run_id
string
required

Response

Successful Response

A browser-use run, as returned by POST /runs and GET /runs/{id}.

On completion: result is the answer string. output is a typed object set ONLY when structuredOutput was requested (else null). browser_id populates once provisioned and persists through completion.

id
string
required

Run id, e.g. "run_...".

status
enum<string>
required
Available options:
queued,
running,
completed,
failed,
stopped
sessionId
string<uuid>
required

The disposable session this run belongs to.

model
string
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
agent
enum<string>
default:browser-use

Always 'browser-use'.

Available options:
browser-use,
browsercode
browserId
string<uuid> | null

The browser this run used. Null until provisioned; persists after completion.

result
string | null

Answer string. Null until the run completes.

output
Output · object | null

Typed output — only when structuredOutput was requested; else null.

error
string | null

Failure reason, if the run failed.

totalCostUsd
string
default:0

USD billed to the project.

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
missingFileIds
string<uuid>[]