# List an agent's share links

Source: https://docs.vlayers.ai/reference/share-links/list-agent-share-links

`GET /v1/agents/{id}/share-links` · scope `share_links:read`

Lists the public share links of one agent, newest first, with each one's limits, what it has used so far and when it was last used. A share link is an address anyone who has it can open to talk to the agent, by voice or by typing, without signing in; what they use is charged to the workspace's balance, up to the link's caps. The list never carries the link itself: it is shown once, when the link is made, and an admin copies it again in the dashboard.

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

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes | The agent id. Example: `"0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78"` |

## Request

cURL:

```bash
curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/share-links" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

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

const voicelayer = new VoiceLayer();

const { links } = await voicelayer.shareLinks.listAgentShareLinks('<agent-id>');
console.log(links);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.shareLinks.list_agent_share_links("<agent-id>")
print(result.links)
```

## Response `200`

```json
{
  "links": [
    {
      "id": "grt_0192f5e1a2b37c4d8e5f6a7b8c9d0e1f",
      "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78",
      "state": "active",
      "title": "Books team test",
      "displayName": "Acme Books",
      "target": "live",
      "sealedVersionLabel": "Published version of Nov 8",
      "sealedAt": "2026-11-08T15:12:00.000Z",
      "privacyUrl": "https://acmebooks.example/privacy",
      "limits": {
        "conversations": 20,
        "voiceMinutes": 60,
        "dollarsMicros": 10000000,
        "atOnce": 2,
        "callMinutes": 5,
        "typedMessages": 40,
        "typedDollarsMicros": 1000000,
        "perAddressPerDay": 5,
        "perAddressPerHour": 3
      },
      "expiresAt": "2026-11-15T15:12:00.000Z",
      "tools": {
        "off": [
          "refund_order",
          "vl_send_text"
        ]
      },
      "usage": {
        "conversations": 3,
        "minutes": 12.5,
        "spentMicros": 1500000
      },
      "lastUsedAt": "2026-11-09T09:30:00.000Z",
      "revokedBy": null,
      "revokedAt": null,
      "createdBy": "user_2abc",
      "createdAt": "2026-11-08T15:12:00.000Z",
      "updatedAt": "2026-11-08T15:12:00.000Z",
      "version": 3
    }
  ]
}
```
