When your connector sleeps

GET
/v1/workspace-connectors/{name}/hosting

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.

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

When the connector sleeps, and what keeping it running all the time would cost a month

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 "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}