List a connector's connections

GET
/v1/workspace-connectors/{name}/connections

Lists the connections of one of your connectors, each with the address to give the provider and whether an agent answers it yet.

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>.

Response Body

The connector's connections, each with its address

application/json
  1. response
connections*array<>
Example Request
curl "https://api.vlayers.ai/v1/workspace-connectors/$CONNECTOR_NAME/connections" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "connections": [    {      "connectionId": "0192f5c3-7a8b-7cad-9e2f-3a4b5c6d7e89",      "connectorId": "ws/0192f5a1-5e6f-7a7b-8c8d-9e0f1a2b3c45/telegram",      "displayName": "Support bot",      "status": "READY",      "host": "api.telegram.org",      "webhookUrl": "https://api.vlayers.ai/v1/connector-webhooks/ws%2F0192f5a1-5e6f-7a7b-8c8d-9e0f1a2b3c45%2Ftelegram/0192f5c3-7a8b-7cad-9e2f-3a4b5c6d7e89",      "bound": true    }  ]}