Start Runtime

POST

/v2/runtimes/:runtimeId/start

POST

/v2/runtimes/:runtimeId/start

$ curl -X POST https://api.bctrl.ai/v2/runtimes/runtimeId/start \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

200Successful

1 {
2   "connection": {
3     "expiresAt": "2024-07-01T12:00:00Z",
4     "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
5     "protocol": "cdp",
6     "url": "wss://cdp.bctrl.ai/runtime/3fa85f64-5717-4562-b3fc-2c963f66afa6"
7   },
8   "live": {
9     "control": "input",
10     "expiresAt": "2024-07-01T12:30:00Z",
11     "url": "https://live.bctrl.ai/view/3fa85f64-5717-4562-b3fc-2c963f66afa6"
12   },
13   "run": {
14     "createdAt": "2024-07-01T11:55:00Z",
15     "id": "7e57d004-2b97-0e7a-b45f-5387367791cd",
16     "runtimeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
17     "runtimeType": "browser",
18     "spaceId": "1c6b147e-8f3a-4d2a-9f3e-2a1b9f4c5d6e",
19     "startedAt": "2024-07-01T11:55:00Z",
20     "status": "active",
21     "durationMs": 300000,
22     "endedReason": "null",
23     "failureReason": "null",
24     "finishedAt": "null",
25     "lastSeenAt": "2024-07-01T12:00:00Z"
26   },
27   "runtime": {
28     "activeRunId": "7e57d004-2b97-0e7a-b45f-5387367791cd",
29     "createdAt": "2024-06-15T08:00:00Z",
30     "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
31     "name": "Chrome Browser Runtime",
32     "status": "active",
33     "type": "browser",
34     "updatedAt": "2024-06-30T18:00:00Z",
35     "config": {},
36     "metadata": {}
37   }
38 }

Start a runtime, open its active run, and return the default CDP connection URL and live view URL.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

runtimeIdstringRequired

Request

This endpoint expects an object.

liveobjectOptional

Response

Default Response

connectionobject

liveobject

runobject

runtimeobject