# Approve a waiting update

Source: https://docs.vlayers.ai/reference/hosting/approve-install-update

`POST /v1/installs/{install}/update` · scope `workspace:write`

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.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `install` | path | string | yes | The install id from `GET /v1/installs`. Example: `"0192f5c3-7a8b-7c9d-8e1f-3a4b5c6d7e89"` |
| `versionId` | body | string | yes | The waiting version, from the install's `pendingUpdate`. |
| `consentToSummary` | body | string | yes | The hash of that update's summary. |

## Request

cURL:

```bash
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"
  }'
```

TypeScript:

```ts
import { VoiceLayer } from '@voicelayer/api';

const voicelayer = new VoiceLayer();

const { versionId } = await voicelayer.hosting.approveInstallUpdate('<install-id>', {
  versionId: '0192f5c1-5e6f-7a8b-9c0d-1e2f3a4b5c67',
  consentToSummary: 'bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb'
});
console.log(versionId);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.hosting.approve_install_update(
    "<install-id>",
    version_id="0192f5c1-5e6f-7a8b-9c0d-1e2f3a4b5c67",
    consent_to_summary="bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
)
print(result.version_id)
```

## Response `200`

```json
{
  "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/orders-panel@1.0.0",
  "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
}
```
