Create Runtime | BCTRL Docs

curl -X POST https://api.bctrl.ai/v1/spaces/id/runtimes \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "type": "string"
}'

{
  "activeRunId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "capabilities": [
    "javascript",
    "cookies",
    "localStorage"
  ],
  "connections": {
    "cdp": {
      "available": true
    },
    "cua": {
      "available": true
    },
    "http": {
      "available": true
    },
    "mcp": {
      "available": false
    },
    "rdp": {
      "available": false
    },
    "vnc": {
      "available": false
    }
  },
  "createdAt": "2024-06-01T12:00:00Z",
  "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "kind": "browser",
  "metadata": {},
  "name": "Primary Browser Runtime",
  "region": "us-west-2",
  "spaceId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "status": "active",
  "type": "browser",
  "updatedAt": "2024-06-01T12:30:00Z",
  "backing": {
    "kind": "ephemeral"
  },
  "summary": {
    "browserRunning": true,
    "currentDriver": "chromedriver-114",
    "defaultContextId": "ctx-12345",
    "defaultPageId": "page-67890",
    "storageSpace": "50MB"
  }
}

Create a live execution environment inside a space. Use a runtime when an agent or external client needs a browser or other managed environment to work in.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

idstringRequired

Request

This endpoint expects an object.

objectRequired

Response

Default Response

activeRunIdstring or nullformat: "uuid"

capabilitieslist of strings

connectionsobject

createdAtstring

idstringformat: "uuid"

kindenum

Allowed values:

metadatamap from strings to any or null

namestring>=1 character

regionstring1-120 characters

spaceIdstringformat: "uuid"

statusenum

Allowed values:

typeenum

Allowed values:

updatedAtstring

backingobject

summaryobject