Get Workflow Yaml Presigned Url | Browser Use Cloud Docs

Get a presigned URL to upload workflow YAML directly to S3 from the browser. This avoids sending the YAML content through the backend, reducing latency and avoiding KMS permission issues in local development.

Authentication

X-Browser-Use-API-Keystring

API Key authentication via header

Path Parameters

workflow_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.

sizeBytesintegerRequired1-5242880

Size of the YAML file in bytes

fileNamestringOptionalDefaults to workflow.yaml

The name of the YAML file to upload

Response

Successful Response

urlstring

The URL to upload the YAML file to

method"POST"

The HTTP method to use for the upload

fieldsmap from strings to strings

The form fields to include in the upload request

s3Keystring

The S3 key where the file will be stored

expiresIninteger

Number of seconds until the presigned URL expires

1	import requests
2
3	url = "https://api.browser-use.com/api/v2/workflows/workflow_id/yaml/presigned-url"
4
5	payload = { "sizeBytes": 1 }
6	headers = {
7	"X-Browser-Use-API-Key": "<apiKey>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())

1	{
2	"url": "string",
3	"method": "string",
4	"fields": {},
5	"s3Key": "string",
6	"expiresIn": 1
7	}

Authentication

Path Parameters

Request

Response

Errors