Approve a waiting update
POST
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.
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.
install*stringThe install id from GET /v1/installs.
application/json- body
versionId*stringThe waiting version, from the install's pendingUpdate.
Length
1 <= length <= 200consentToSummary*stringThe hash of that update's summary.
Match
^[0-9a-f]{64}$The install, now on the new version
application/json- response
id*stringFormat
uuidpackageId*stringkind*stringValue in
"connector""tool-set""agent-template""mcp-server""plugin"publisherWorkspaceId*stringversionId*stringlabel*stringstate*stringValue in
"active""stopped"updateMode*stringValue in
"manual""automatic"summary*consentedBy*stringconsentedAt*stringFormat
date-timenotice*|nullpendingUpdate*|nullsizeClass*stringValue in
"small""medium""large"warmCount*integerscreens*booleancurl -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}