# Get a shareable meeting link

`POST /meeting.shareLink`

## Description

Returns a shareable URL for a meeting that you can distribute to others. Pass the `id` of a meeting obtained from [`/meeting.list`](/docs/api/meeting-list) or [`/meeting.info`](/docs/api/meeting-info).

This endpoint is **get-or-create**: it returns the meeting's existing share link, or mints one the first time it is called for that meeting. Repeat calls for the same meeting return the same URL.

Creating a share link is a deliberate action, which is why it has its own endpoint rather than being returned as a field on `meeting.list` / `meeting.info` — fetching a meeting never mints a shareable link as a side effect. You can only create a share link for a meeting you can access; the same access check as `meeting.info` applies.

**Access:** Organization and Personal. Personal access tokens restrict to meetings the authenticated user participated in.

**Required scope:** `meetings:read`

---

**OpenAPI Spec:** [chat-v1.json](https://developer.ro.am/chat-v1.json)

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Request Body

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | string | Yes | The meeting ID. |

## Responses

### 200 - The meeting's shareable link.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | string | Yes | The meeting ID. |
| `url` | string | Yes | The shareable meeting URL. |


#### Example Response

```json
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "url": "https://ro.am/share/abc123xyz"
}
```

### 400 - Bad request. Missing `id`.

### 401 - Presented invalid authentication credentials.

### 404 - Meeting not found or not accessible.

### 405 - An unsupported method was requested.

### 500 - An internal error occurred.

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/api/meeting-share-link*