List targets.

GET/accounts/{account_id}/browser-rendering/devtools/browser/{session_id}/json/list

Returns a list of all debuggable targets including tabs, pages, service workers, and other browser contexts.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

Accepted Permissions (at least one required)

Browser Rendering WriteBrowser Rendering Read

Path ParametersExpand Collapse

account_id: string

Account ID.

session_id: string

Browser session ID.

formatuuid

ReturnsExpand Collapse

id: string

Target ID.

type: string

Target type (page, background_page, worker, etc.).

url: string

URL of the target.

description: optional string

Target description.

devtoolsFrontendUrl: optional string

DevTools frontend URL.

title: optional string

Title of the target.

webSocketDebuggerUrl: optional string

WebSocket URL for debugging this target.

List targets.

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/browser-rendering/devtools/browser/$SESSION_ID/json/list \
    -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

[
  {
    "id": "id",
    "type": "type",
    "url": "url",
    "description": "description",
    "devtoolsFrontendUrl": "devtoolsFrontendUrl",
    "title": "title",
    "webSocketDebuggerUrl": "webSocketDebuggerUrl"
  }
]

Returns Examples

[
  {
    "id": "id",
    "type": "type",
    "url": "url",
    "description": "description",
    "devtoolsFrontendUrl": "devtoolsFrontendUrl",
    "title": "title",
    "webSocketDebuggerUrl": "webSocketDebuggerUrl"
  }
]