Get a runtime | BCTRL Docs

{
  "activeRunId": "run_AAAAAAAAAAAAAAAAAAAAAA",
  "createdAt": "2026-07-26T12:00:00Z",
  "id": "rt_AAAAAAAAAAAAAAAAAAAAAA",
  "name": "string",
  "profile": true,
  "spaceId": "sp_AAAAAAAAAAAAAAAAAAAAAA",
  "status": "active",
  "type": "string",
  "updatedAt": "2026-07-26T12:00:00Z",
  "archivedAt": "2026-07-26T12:00:00Z",
  "config": {
    "headless": true,
    "autoUpgrade": true,
    "extensionIds": [
      "string"
    ],
    "fingerprint": {
      "browser": "chrome",
      "browserVersion": "string",
      "device": "desktop",
      "locale": "string",
      "os": "windows",
      "timezone": "string",
      "userAgent": "string",
      "viewport": {
        "height": 1,
        "width": 1
      }
    },
    "forceOpenShadowRoots": true,
    "idleTimeoutSeconds": 1,
    "networkTraffic": {
      "blockAds": true,
      "blockResourceTypes": [
        "media"
      ],
      "blockTrackers": true,
      "saver": "none",
      "urlAllowlist": [
        "string"
      ],
      "urlBlocklist": [
        "string"
      ]
    },
    "proxy": {
      "id": "string",
      "name": "string",
      "type": "custom"
    },
    "stealth": "normal",
    "webRtcProxyOnly": true
  },
  "connection": {
    "cdpUrl": "string",
    "expiresAt": "2024-01-15T09:30:00Z",
    "recording": {
      "enabled": true
    },
    "runId": "run_AAAAAAAAAAAAAAAAAAAAAA",
    "webDriverUrl": "string",
    "webMcpUrl": "string"
  },
  "lastActivityAt": "2026-07-26T12:00:00Z",
  "latestRun": {
    "finishedAt": "2026-07-26T12:00:00Z",
    "id": "run_AAAAAAAAAAAAAAAAAAAAAA",
    "startedAt": "2026-07-26T12:00:00Z",
    "status": "active"
  },
  "metadata": {},
  "needsInput": true
}

Get one runtime using the simplified runtime detail resource.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

runtimeIdstringRequired

Unique runtime identifier generated by BCTRL.

Query parameters

include"connection"Optional

Response

activeRunIdstring or null

createdAtdatetime

RFC 3339 timestamp with a UTC offset.

idstring

Unique runtime identifier generated by BCTRL.

namestring

profileboolean

spaceIdstring

Unique space identifier generated by BCTRL.

statusenum

type"browser"

updatedAtdatetime

RFC 3339 timestamp with a UTC offset.

archivedAtdatetimeOptional

RFC 3339 timestamp with a UTC offset.

configobjectOptional

connectionobjectOptional

lastActivityAtdatetimeOptional

RFC 3339 timestamp with a UTC offset.

latestRunobject or nullOptional

Most recent run of this runtime (the active one when a run is open). Null when the runtime has never run.

metadataobject or nullOptional

needsInputbooleanOptional

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

$	curl https://api.bctrl.ai/v1/runtimes/runtimeId \
>	-H "Authorization: Bearer <token>"

Authentication

Path parameters

Headers

Query parameters

Response

Errors