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

generationErrorstring or null

Error message if generation failed

generationProgressstring or null

Current progress step (e.g., “downloading_history”, “detecting_variables”)

liveUrlstring or null

Live browser view URL (available only during generation)

stepslist of objects or null

List of generated workflow steps (available after completion)

updatedAtdatetime or null

When workflow was last updated

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	"generationError": "string",
7	"generationProgress": "string",
8	"liveUrl": "string",
9	"steps": [
10	{
11	"stepNumber": 1,
12	"actionType": "string",
13	"description": "string",
14	"url": "string",
15	"timestamp": "string",
16	"selector": "string",
17	"targetText": "string"
18	}
19	],
20	"updatedAt": "2024-01-15T09:30:00Z"
21	}