# Publish a version of your connector

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

`POST /v1/workspace-connectors/{name}/versions` · scope `workspace:write`

Seals a version from a manifest (what the connector verifies, reads, sends and keeps open: `inbound`, `sends`, `live`, `egressHosts`) and an image by digest, and starts its room. The manifest's `id` must be `ws/<your workspace>/<name>`, and only attribution from the URL is served. A manifest with problems is refused with 422 `manifest_invalid`, each problem with its path; a tag, or an image from another repository, with 422 `image_refused`. The answer is 202: the version goes live once its room has registered, and `GET /v1/workspace-connectors/{name}/versions/{version}` says how that is going.

Requires an API key with the `workspace:write` scope.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `name` | path | string | yes | The connector name: the last part of `ws/<workspace>/<name>`. Example: `"telegram"` |
| `manifest` | body | object | yes | The connector manifest (an object). It names no secret: credentials stay with each connection. |
| `image` | body | string | yes | The pushed image, by digest: `sha256:…` or `registry.vlayers.ai/<workspace>/<connector>@sha256:…`. A tag is refused. |
| `note` | body | string | no | A note kept with the version (up to 500 characters). |

## Request

cURL:

```bash
curl -X POST "https://api.vlayers.ai/v1/workspace-connectors/$CONNECTOR_NAME/versions" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "manifest": {
      "id": "ws/org_1234/telegram",
      "displayName": "Telegram",
      "channels": [
        "web"
      ],
      "inbound": {
        "verification": {
          "scheme": "secret_token_header",
          "header": "x-telegram-bot-api-secret-token"
        },
        "events": [
          {
            "kind": "message",
            "id": {
              "from": "json",
              "path": "update_id"
            }
          }
        ]
      },
      "egressHosts": [
        "api.telegram.org"
      ]
    },
    "image": "sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
  }'
```

TypeScript:

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

const voicelayer = new VoiceLayer();

const { state } = await voicelayer.hosting.submitWorkspaceConnectorVersion('<connector-name>', {
  manifest: {
    id: 'ws/org_1234/telegram',
    displayName: 'Telegram',
    channels: ['web'],
    inbound: {
      verification: {
        scheme: 'secret_token_header',
        header: 'x-telegram-bot-api-secret-token'
      },
      events: [{ kind: 'message', id: { from: 'json', path: 'update_id' } }]
    },
    egressHosts: ['api.telegram.org']
  },
  image: 'sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef'
});
console.log(state);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.hosting.submit_workspace_connector_version(
    "<connector-name>",
    manifest={
        "id": "ws/org_1234/telegram",
        "displayName": "Telegram",
        "channels": ["web"],
        "inbound": {
            "verification": {
                "scheme": "secret_token_header",
                "header": "x-telegram-bot-api-secret-token",
            },
            "events": [{
                "kind": "message",
                "id": {
                    "from": "json",
                    "path": "update_id",
                },
            }],
        },
        "egressHosts": ["api.telegram.org"],
    },
    image="sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
)
print(result.state)
```

## Response `202`

```json
{
  "connectorId": "ws/0192f5a1-5e6f-7a7b-8c8d-9e0f1a2b3c45/telegram",
  "version": 3,
  "versionId": "0192f5d5-9cad-7ebf-9a4b-5c6d7e8f9012",
  "state": "sealed",
  "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": "starting",
      "stateChangedAt": "2026-10-20T15:04:05.000Z"
    }
  ],
  "failure": null
}
```
