API ReferenceAPI v3 (Experimental)Files

List Session Files

List files in a session’s workspace.

Returns paginated file metadata. Pass includeUrls=true to get presigned download URLs (60s expiry) inline with each file.

Authentication

X-Browser-Use-API-Keystring
API Key authentication via header

Path parameters

session_idstringRequiredformat: "uuid"

Query parameters

prefixstringOptionalDefaults to
limitintegerOptional1-100Defaults to 50
cursorstring or nullOptional
includeUrlsbooleanOptionalDefaults to false

Response

Successful Response
fileslist of objects
nextCursorstring or null
hasMoreboolean or nullDefaults to false

Errors