See how a connector publish is going
GET
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.
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.
name*stringThe connector name: the last part of ws/<workspace>/<name>.
version*stringThe version number, as the agent numbers its versions (1, 2, 3, …).
Where the version stands
application/json- response
connectorId*stringLength
1 <= lengthversion*integerRange
1 <= valueversionId*stringFormat
uuidstate*stringValue in
"sealed""published""superseded""failed"manifestHash*stringMatch
^[0-9a-f]{64}$image*rooms*array<>failure*|nullcurl "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}