When a package sleeps

GET
/v1/installs/{install}/hosting

Shows how long the package waits with nothing to do before it sleeps (settings.sleepAfterIdleMinutes, or null when it is always on) and what keeping it running all the time would cost a month.

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

install*string

The install id from GET /v1/installs.

Response Body

When the package 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/installs/$INSTALL_ID/hosting" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "kind": "install",  "unitId": "0192f5c1-5e6f-7a8b-9c0d-1e2f3a4b5c67",  "name": "com.example/[email protected]",  "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}