List installed packages

GET
/v1/installs

Lists the third-party packages installed in your workspace, each with the summary of what it can do that you agreed to, whether it is running or stopped (and the words of whoever stopped it), and any newer version waiting for your word.

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.

Response Body

The installed packages, each with the summary consented to, why it is stopped and any update waiting

application/json
  1. response
installs*array<>
Example Request
curl https://api.vlayers.ai/v1/installs \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "installs": [    {      "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    }  ]}