# Link to talk to an agent

Source: https://docs.vlayers.ai/reference/test/create-agent-try-link

`POST /v1/agents/{id}/try-link` · scope `workspace:read`

Makes a short-lived link to the agent's talk page in the dashboard, where a signed-in member of the workspace can talk to it by voice or text (the draft or what is live). A terminal can print it for the person to open. The link stops working after `expiresAt` and opens only for a member of the workspace the agent is in. Talking is charged as testing, as in the Playground.

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

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

## Request

cURL:

```bash
curl -X POST "https://api.vlayers.ai/v1/agents/$AGENT_ID/try-link" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

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

const voicelayer = new VoiceLayer();

const { url } = await voicelayer.test.createAgentTryLink('<agent-id>');
console.log(url);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.test.create_agent_try_link("<agent-id>")
print(result.url)
```

## Response `200`

```json
{
  "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78",
  "url": "https://vlayers.ai/dashboard/playground?agent=0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78&try=eyJ2IjoxfQ.0f3a",
  "expiresAt": "2026-10-20T15:04:05.000Z"
}
```
