List Agents

List the agents this platform exposes — the routing truth.

Each entry carries capabilities + session.kind (structured routing signal) plus best_for / not_for / example_tasks hints and the run endpoint. The run BODY schema lives in the OpenAPI spec, not here. Filter with ?capability= (e.g. code → only agents that can run code).

GET /agents

List Agents

JavaScript

const options = {method: 'GET', headers: {'X-Browser-Use-API-Key': '<api-key>'}};

fetch('https://api-staging-ufcbwvyv9yifyyvc3.browser-use.com/api/v1/agents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request GET \
  --url https://api-staging-ufcbwvyv9yifyyvc3.browser-use.com/api/v1/agents \
  --header 'X-Browser-Use-API-Key: <api-key>'

import requests

url = "https://api-staging-ufcbwvyv9yifyyvc3.browser-use.com/api/v1/agents"

headers = {"X-Browser-Use-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

200

{
  "agents": [
    {
      "capabilities": [],
      "session": {},
      "bestFor": "<string>",
      "notFor": "<string>",
      "exampleTasks": [
        "<string>"
      ],
      "run": "<string>"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

X-Browser-Use-API-Key · string · header · required

Query Parameters

capability · enum<string> | null

Filter to agents that expose this capability, e.g. ?capability=code. The closed set of agent capabilities — the registry's routing TRUTH.

capabilities on an agent is platform-enforced: sending workspace_id to an agent that lacks files → 400 naming the right agent. Both agents do browser + files; the only structural difference is code / terminal (browsercode).

Available options: browser, code, terminal, files

Response

200

application/json

Successful Response

The registry: every agent this platform exposes.

Not paginated — the agent list is tiny and fully enumerable. A plain array so an LLM can read the whole routing table in one call.

agents · AgentInfo · object[] · required

Show child attributes