> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.voicebip.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.voicebip.com/_mcp/server.

# Shareable Links

> Generate public "try my agent" links that let anyone test-call your AI agent from a browser.

Enable shareable links on any agent to generate a public URL that lets anyone test-call your AI agent directly from their browser -- no phone needed, no signup required.

## Enable Shareable

```bash
curl -X PATCH "https://api.voicebip.com/v1/agents/{agent_id}/shareable" \
  -H "Authorization: Bearer pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"shareable": true}'
```

Once enabled, the shareable link follows this format:

```
https://app.voicebip.com/try/{agent_id}
```

Share this link with potential customers, investors, or teammates. They can call your agent from any modern browser with a microphone.

## Disable Shareable

```bash
curl -X PATCH "https://api.voicebip.com/v1/agents/{agent_id}/shareable" \
  -H "Authorization: Bearer pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"shareable": false}'
```

Existing calls in progress are not interrupted, but no new calls can be started.

## Rate Limits

Shareable links have their own rate limits (separate from API key rate limits):

| Limit                      | Value |
| -------------------------- | ----- |
| Concurrent calls per agent | 10    |
| Calls per day per agent    | 50    |

When limits are exceeded, the endpoint returns HTTP 503 with error code `AGENT_BUSY`. If the agent's workspace has no remaining credits, the endpoint returns HTTP 402 with error code `INSUFFICIENT_BALANCE`.

## How It Works

The shareable link page uses WebRTC for browser-to-server audio:

1. User opens the shareable link in their browser
2. Browser requests microphone permission
3. Browser creates a WebRTC SDP offer
4. `POST /v1/public/try/{agent_id}/offer` sends the offer to the server (no auth required)
5. Server verifies the agent exists and `shareable == true`
6. Server returns an SDP answer
7. WebRTC peer connection is established
8. Audio flows through the normal voice pipeline (STT, AI, TTS)

## Setting Up the Agent

For the best shareable experience:

1. **Set a greeting** - The greeting text plays automatically when the call connects:

```bash
curl -X PATCH "https://api.voicebip.com/v1/agents/{agent_id}" \
  -H "Authorization: Bearer pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"greeting_text": "Hi! I am the Acme Finance assistant. How can I help you today?"}'
```

2. **Use a template** - Templates come with pre-written greetings and system prompts
3. **Test first** - Use the dashboard's built-in browser call to test before sharing

## Security

* No authentication is required for the public endpoint
* The agent must have `shareable: true` (returns 404 otherwise)
* IP-based rate limiting prevents abuse
* No PII from the agent's workspace is exposed to the caller
* Demo workspace type (`demo`) enables real SIP calls at zero billing cost for landing page demos