# List outside desks

Source: https://docs.vlayers.ai/reference/channels/list-desks

`GET /v1/desks` · scope `workspace:read`

The outside desks a workspace can connect (a desk is a place a person answers a text conversation that VoiceLayer keeps relaying) and this workspace's desk connections, each with the addresses to point the desk at. Setup runs through the ordinary connection and onboarding routes. Nothing secret is in the answer.

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

## Request

cURL:

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

TypeScript:

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

const voicelayer = new VoiceLayer();

const { desks } = await voicelayer.channels.listDesks();
console.log(desks);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.channels.list_desks()
print(result.desks)
```

## Response `200`

```json
{
  "desks": [
    {
      "id": "vl/helpdesk",
      "displayName": "Example desk",
      "publisher": "VoiceLayer",
      "version": "1.0.0",
      "consoleUrl": null,
      "workflow": {
        "version": 1,
        "steps": []
      }
    }
  ],
  "connections": [
    {
      "id": "0192f5b0-7c3e-7a51-9b2d-4e8f1a6c3d21",
      "connectorId": "vl/helpdesk",
      "displayName": "Support desk",
      "status": "active",
      "hooks": [
        {
          "label": "Webhook",
          "help": null,
          "url": null
        }
      ]
    }
  ]
}
```
