# See how a connector publish is going

Source: https://docs.vlayers.ai/reference/hosting/get-workspace-connector-version

`GET /v1/workspace-connectors/{name}/versions/{version}` · scope `workspace:read`

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.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `name` | path | string | yes | The connector name: the last part of `ws/<workspace>/<name>`. Example: `"telegram"` |
| `version` | path | string | yes | The version number, as the agent numbers its versions (1, 2, 3, …). Example: `"3"` |

## Request

cURL:

```bash
curl "https://api.vlayers.ai/v1/workspace-connectors/$CONNECTOR_NAME/versions/$VERSION" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

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

const voicelayer = new VoiceLayer();

const { state } = await voicelayer.hosting.getWorkspaceConnectorVersion('<connector-name>', '<version>', {

});
console.log(state);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.hosting.get_workspace_connector_version("<connector-name>", "<version>")
print(result.state)
```

## Response `200`

```json
{
  "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
}
```
