See how a connector publish is going

GET
/v1/workspace-connectors/{name}/versions/{version}

Says where a submitted version stands: sealed while its room starts, published once it is live (the version it replaced is superseded), or failed with the room's own words and the tail of its logs. Each call also moves the version along.

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.

Path Parameters

name*string

The connector name: the last part of ws/<workspace>/<name>.

version*string

The version number, as the agent numbers its versions (1, 2, 3, …).

Response Body

Where the version stands

application/json
  1. response
connectorId*string
Length1 <= length
version*integer
Range1 <= value
versionId*string
Formatuuid
state*string
Value in"sealed""published""superseded""failed"
manifestHash*string
Match^[0-9a-f]{64}$
image*
rooms*array<>
failure*|null
Example Request
curl "https://api.vlayers.ai/v1/workspace-connectors/$CONNECTOR_NAME/versions/$VERSION" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "connectorId": "ws/0192f5a1-5e6f-7a7b-8c8d-9e0f1a2b3c45/telegram",  "version": 3,  "versionId": "0192f5d5-9cad-7ebf-9a4b-5c6d7e8f9012",  "state": "published",  "manifestHash": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",  "image": {    "digest": "sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",    "repository": "registry.vlayers.ai/0192f5a1-5e6f-7a7b-8c8d-9e0f1a2b3c45/0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78",    "workspaceId": "0192f5a1-5e6f-7a7b-8c8d-9e0f1a2b3c45",    "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78",    "pushedAt": "2026-10-20T15:04:05.000Z",    "sizeBytes": 148000000,    "platform": "linux/amd64",    "scan": {      "status": "complete",      "scanner": "trivy",      "scannedAt": "2026-10-20T15:04:05.000Z",      "findings": {        "critical": 0,        "high": 1,        "medium": 4,        "low": 9,        "unknown": 0      },      "reportRef": null,      "error": null    },    "sbom": {      "format": "spdx-json",      "ref": "sbom/0123456789ab.json"    },    "referencedBy": 1  },  "rooms": [    {      "id": "room_0192f5d4-8b9c-7dae-8f3a-4b5c6d7e8f90",      "state": "ready",      "stateChangedAt": "2026-10-20T15:04:05.000Z"    }  ],  "failure": null}