Create Runtime Connection

Create a short-lived connection lease for a runtime. Use this to mint credentials for an external client that needs to attach to the runtime.

AuthorizationBearer

Use Bearer <api-key>.

runtimeIdstringRequired

This endpoint expects an object.

protocolenumRequired

Allowed values:

optionsobjectOptional

ttlSecondsintegerOptional60-7200

Default Response

createdAtdatetime

endpointobject

expiresAtdatetime or null

idstringformat: "uuid"

protocolenum

runIdstringformat: "uuid"

statusenum

Allowed values:

closedAtdatetime or null

revokedAtdatetime or null

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

1	{
2	"createdAt": "2024-01-15T08:30:00Z",
3	"endpoint": {
4	"type": "websocket",
5	"url": "wss://runtime-connection.bctrl.ai/session/abc123"
6	},
7	"expiresAt": "2024-01-15T10:30:00Z",
8	"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
9	"protocol": "cdp",
10	"runId": "7e57d004-2b97-0e7a-b45f-5387367791cd",
11	"status": "active",
12	"closedAt": "2024-01-15T10:30:00Z",
13	"revokedAt": "null"
14	}