---
title: "Get Shareable Agent Link"
method: GET
path: "/v1/convai/agents/{agent_id}/link"
tags: ["Agents Platform"]
---

# Get Shareable Agent Link

`GET /v1/convai/agents/{agent_id}/link`

Get the current link used to share the agent with others

## Path parameters

- `agent_id` string, required — The id of an agent. This is returned on agent creation.

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- GetAgentLinkResponseModel
  - `agent_id` string, required — The ID of the agent
  - `token` ConversationTokenResponseModel
    - `agent_id` string, required — The ID of the agent
    - `conversation_token` string, required — The token for the agent
    - `expiration_time_unix_secs` integer, nullable — The expiration time of the token in unix seconds
    - `conversation_id` string, nullable — The ID of the conversation
    - `purpose` 'signed_url' | 'shareable_link', required
    - `token_requester_user_id` string, nullable — The user ID of the entity who requested the token

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/versions/57d56f34628a/schema)