# List your own connectors

Source: https://docs.vlayers.ai/reference/hosting/list-workspace-connectors

`GET /v1/workspace-connectors` · scope `workspace:read`

Lists the connectors you wrote yourself (`ws/<workspace>/<name>`): the repository each one's image is pushed to, and the version that is live now, if any.

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

## Request

cURL:

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

TypeScript:

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

const voicelayer = new VoiceLayer();

const { connectors } = await voicelayer.hosting.listWorkspaceConnectors();
console.log(connectors);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.hosting.list_workspace_connectors()
print(result.connectors)
```

## Response `200`

```json
{
  "connectors": [
    {
      "connectorId": "ws/0192f5a1-5e6f-7a7b-8c8d-9e0f1a2b3c45/telegram",
      "name": "telegram",
      "repository": "registry.vlayers.ai/0192f5a1-5e6f-7a7b-8c8d-9e0f1a2b3c45/0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78",
      "published": {
        "version": 3,
        "versionId": "0192f5d5-9cad-7ebf-9a4b-5c6d7e8f9012",
        "publishedAt": "2026-10-20T15:04:05.000Z"
      },
      "latestVersion": 3,
      "requirements": {
        "handshakeToken": false,
        "primary": true,
        "hosts": [
          "api.telegram.org"
        ]
      }
    }
  ]
}
```
