Keep your connector always on

POST
/v1/workspace-connectors/{name}/hosting/always-on

Turns sleep off: the connector keeps its room every hour and is billed at the room's hourly price for each (about alwaysOnMonthlyUsd a month). Refused with always_on_full when the plan's always-on rooms, or the server's share of them, are used up; the refusal is recorded on the connector. Asking for a connector already always on changes nothing.

Requires an API key with the workspace:write scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Path Parameters

name*string

The connector name: the last part of ws/<workspace>/<name>.

Response Body

The connector, now always on

application/json
  1. response
kind*string
Value in"connector""install"
unitId*string
Formatuuid
name*string
settings*
alwaysOn*boolean
sizeClass*string
Value in"small""medium""large"
warmCount*integer
Range1 <= value
hourlyUsd*number
Range0 <= value
alwaysOnMonthlyUsd*number
Range0 <= value
lastActiveAt*|
Formatdate-time
pollsEverySeconds*|
Range1 <= value
staysAwakeBySchedule*boolean
Example Request
curl -X POST "https://api.vlayers.ai/v1/workspace-connectors/$CONNECTOR_NAME/hosting/always-on" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "kind": "connector",  "unitId": "0192f5c1-5e6f-7a8b-9c0d-1e2f3a4b5c67",  "name": "telegram",  "settings": {    "sleepAfterIdleMinutes": null  },  "alwaysOn": true,  "sizeClass": "small",  "warmCount": 1,  "hourlyUsd": 0.03,  "alwaysOnMonthlyUsd": 21.9,  "lastActiveAt": "2026-10-20T15:04:05.000Z",  "pollsEverySeconds": null,  "staysAwakeBySchedule": false}