Keep a package always on

POST
/v1/installs/{install}/hosting/always-on

Turns sleep off: the package keeps its room every hour and is billed at the room's hourly price for each. Refused with always_on_full when the plan's always-on rooms, or the server's share of them, are used up.

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

install*string

The install id from GET /v1/installs.

Response Body

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