When your connector sleeps
GET
Shows how long the connector waits with nothing to do before it sleeps (settings.sleepAfterIdleMinutes, or null when it is always on), what keeping it running all the time would cost a month (alwaysOnMonthlyUsd: the room's hourly price times 730), and whether a schedule it declares fires more often than that wait, which keeps it awake.
Requires an API key with the workspace:read scope.
apiKeyheader
AuthorizationBearer <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.
name*stringThe connector name: the last part of ws/<workspace>/<name>.
When the connector sleeps, and what keeping it running all the time would cost a month
application/json- response
kind*stringValue in
"connector""install"unitId*stringFormat
uuidname*stringsettings*alwaysOn*booleansizeClass*stringValue in
"small""medium""large"warmCount*integerRange
1 <= valuehourlyUsd*numberRange
0 <= valuealwaysOnMonthlyUsd*numberRange
0 <= valuelastActiveAt*|Format
date-timepollsEverySeconds*|Range
1 <= valuestaysAwakeBySchedule*booleancurl "https://api.vlayers.ai/v1/workspace-connectors/$CONNECTOR_NAME/hosting" \ -H "Authorization: Bearer $VOICELAYER_API_KEY"Example Response
{ "kind": "connector", "unitId": "0192f5c1-5e6f-7a8b-9c0d-1e2f3a4b5c67", "name": "telegram", "settings": { "sleepAfterIdleMinutes": 30 }, "alwaysOn": false, "sizeClass": "small", "warmCount": 1, "hourlyUsd": 0.03, "alwaysOnMonthlyUsd": 21.9, "lastActiveAt": "2026-10-20T15:04:05.000Z", "pollsEverySeconds": null, "staysAwakeBySchedule": false}