Drex

Get a browser run

The run: its status, and once it ended its answer, outcome, steps and usage. Free.

GET
/v1/browser/runs/{id}

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

Path Parameters

idstringrequired

The run's id (brun_...).

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/browser/runs/string"
{  "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"}