curl https://backend.talking-avatar.dev/api/talking-avatar/voice-agents/AGENT_ID/links \
-H "Authorization: Bearer $TALKING_AVATAR_API_KEY"
import { listAgentLinks } from "@interviewflowai/talking-avatar/server";
const links = await listAgentLinks({ apiKey: process.env.TALKING_AVATAR_API_KEY, agentId: "AGENT_ID" });
{
"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
}
Private agent links
List links
A voice agent’s links, newest first, expired and used-up ones included.
GET
/
api
/
talking-avatar
/
voice-agents
/
{agentId}
/
links
curl https://backend.talking-avatar.dev/api/talking-avatar/voice-agents/AGENT_ID/links \
-H "Authorization: Bearer $TALKING_AVATAR_API_KEY"
import { listAgentLinks } from "@interviewflowai/talking-avatar/server";
const links = await listAgentLinks({ apiKey: process.env.TALKING_AVATAR_API_KEY, agentId: "AGENT_ID" });
{
"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
}
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.
string
required
Bearer tav_…, your API key.string
required
The voice agent’s ID.
Response
object[]
The links, each with
id, name, token, url, expires_at, max_uses, uses and created_at. See Create a link.curl https://backend.talking-avatar.dev/api/talking-avatar/voice-agents/AGENT_ID/links \
-H "Authorization: Bearer $TALKING_AVATAR_API_KEY"
import { listAgentLinks } from "@interviewflowai/talking-avatar/server";
const links = await listAgentLinks({ apiKey: process.env.TALKING_AVATAR_API_KEY, agentId: "AGENT_ID" });
{
"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
}