> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talking-avatar.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# List links

> A voice agent's links, newest first, expired and used-up ones included.

Returns up to the 200 newest links. A link is usable while `expires_at` is in the future and, if `max_uses` is set, `uses` is below it.

**Authorization** `string` *required*

`Bearer tav_…`, your API key.

**agentId** `string` *required*

The voice agent's ID.

### Response

**data** `object[]`

The links, each with `id`, `name`, `token`, `url`, `expires_at`, `max_uses`, `uses` and `created_at`. See [Create a link](https://docs.talking-avatar.dev/api-reference/agent-links/create.md#response).

```bash cURL theme={null}
curl https://backend.talking-avatar.dev/api/talking-avatar/voice-agents/AGENT_ID/links \
  -H "Authorization: Bearer $TALKING_AVATAR_API_KEY"
```

```js Node.js (SDK) theme={null}
import { listAgentLinks } from "@interviewflowai/talking-avatar/server";

const links = await listAgentLinks({ apiKey: process.env.TALKING_AVATAR_API_KEY, agentId: "AGENT_ID" });
```

```json 200 theme={null}
{
  "data": [
    {
      "id": "6f2c1b0e-4d7a-4a51-9a3e-2b8c7d1e9f40",
      "name": "Interview with Jane",
      "token": "q3N1dGh4YkVwV2Zz…",
      "url": "https://app.talking-avatar.dev/agent/AGENT_ID?token=q3N1dGh4YkVwV2Zz…",
      "expires_at": "2026-11-02T09:00:00+00:00",
      "max_uses": 1,
      "uses": 1,
      "created_at": "2026-10-26T10:15:00+00:00"
    }
  ],
  "code": 200
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.