Approve a waiting update

POST
/v1/installs/{install}/update

Moves the install to the newer version that is waiting. You agree to the hash of the new summary (consentToSummary); a version that changed since you read it is refused with its new summary. An update that widens what the package can do always waits for this call.

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.

Request Body

application/json
  1. body
versionId*string

The waiting version, from the install's pendingUpdate.

Length1 <= length <= 200
consentToSummary*string

The hash of that update's summary.

Match^[0-9a-f]{64}$

Response Body

The install, now on the new version

application/json
  1. response
id*string
Formatuuid
packageId*string
kind*string
Value in"connector""tool-set""agent-template""mcp-server""plugin"
publisherWorkspaceId*string
versionId*string
label*string
state*string
Value in"active""stopped"
updateMode*string
Value in"manual""automatic"
summary*
consentedBy*string
consentedAt*string
Formatdate-time
notice*|null
pendingUpdate*|null
sizeClass*string
Value in"small""medium""large"
warmCount*integer
screens*boolean
Example Request
curl -X POST "https://api.vlayers.ai/v1/installs/$INSTALL_ID/update" \  -H "Authorization: Bearer $VOICELAYER_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "versionId": "0192f5c1-5e6f-7a8b-9c0d-1e2f3a4b5c67",    "consentToSummary": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"  }'
Example Response
{  "id": "0192f5c3-7a8b-7c9d-8e1f-3a4b5c6d7e89",  "packageId": "com.example/orders-panel",  "kind": "tool-set",  "publisherWorkspaceId": "org_publisher",  "versionId": "0192f5c1-5e6f-7a8b-9c0d-1e2f3a4b5c67",  "label": "com.example/[email protected]",  "state": "active",  "updateMode": "manual",  "summary": {    "lines": [      {        "section": "hosts",        "key": "host:api.example.com",        "text": "It can send data to api.example.com."      }    ],    "hash": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"  },  "consentedBy": "user_2abc",  "consentedAt": "2026-10-20T15:04:05.000Z",  "notice": null,  "pendingUpdate": null,  "sizeClass": "small",  "warmCount": 1,  "screens": false}