Drex

List browser runs

The account's runs, newest first, without steps. Free.

GET
/v1/browser/runs

Authorization

bearerAuth
AuthorizationBearer <token>

Your API key, sent as Authorization: Bearer nace_sk_...

  • Where: the dashboard's API Keys page. It is shown once, when you create it.
  • Format: nace_sk_ followed by 43 URL-safe characters (A-Z, a-z, 0-9, _ and -).
  • Limit: an account can hold at most 3 active keys.
  • Wrong or missing key: returns 401 authentication_error.

In: header

Query Parameters

limitinteger
Range1 <= value <= 50
Default20
statusstring

Only runs with this status.

Value in"queued""running""succeeded""partial""failed""cancelled""timed_out"
cursorstring

next_cursor from the previous page.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/browser/runs"
{  "items": [    {      "id": "string",      "object": "browser_run",      "status": "queued",      "task": "string",      "start_url": "string",      "allowed_origins": [        "string"      ],      "risky_actions": "string",      "limits": {        "max_cost_usd": 0.04,        "max_seconds": 600,        "max_llm_calls": 20      },      "answer": null,      "answer_text": "string",      "outcome": {        "kind": "completed",        "reason": "string",        "evidence": [          {            "url": "string",            "text": "string"          }        ]      },      "final_url": "string",      "steps": [        {}      ],      "pending_approval": null,      "usage": {        "drex_input_tokens": 0,        "llm_input_tokens": 0,        "llm_output_tokens": 0,        "browser_seconds": 0,        "cost_usd": 0      },      "artifacts_url": "string",      "metadata": {        "property1": "string",        "property2": "string"      },      "created_at": "2019-08-24T14:15:22Z",      "started_at": "2019-08-24T14:15:22Z",      "finished_at": "2019-08-24T14:15:22Z"    }  ],  "next_cursor": "string"}