Get Workflow Generation State | Browser Use Cloud Docs

Get workflow generation state with live browser URL for polling.

This endpoint returns the current state of workflow generation including the live browser URL (if available). It’s designed to be polled every 2 seconds during generation to show real-time browser activity in the frontend.

Authentication

X-Browser-Use-API-Keystring

API Key authentication via header

Path Parameters

workflow_idstringRequiredformat: "uuid"

Response

Successful Response

idstringformat: "uuid"

Unique identifier for the workflow

namestring

Name of the workflow

generationStatusenum

Current status of workflow generation

Allowed values:

createdAtdatetime

When workflow was created

liveUrlstring or null

Live browser view URL (available only during generation)

stepslist of objects or null

List of generated workflow steps (available after completion)

1	import requests
2
3	url = "https://api.browser-use.com/api/v2/workflows/workflow_id/generation-state"
4
5	headers = {"X-Browser-Use-API-Key": "<apiKey>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"id": "string",
3	"name": "string",
4	"generationStatus": "pending",
5	"createdAt": "2024-01-15T09:30:00Z",
6	"liveUrl": "string",
7	"steps": [
8	{
9	"stepNumber": 1,
10	"actionType": "string",
11	"description": "string",
12	"url": "string",
13	"timestamp": "string",
14	"selector": "string",
15	"targetText": "string"
16	}
17	]
18	}

Authentication

Path Parameters

Response

Errors