---
title: "List meeting permissions"
method: GET
path: "/meetings/{meeting_id}/permissions"
tags: ["meetings"]
---

# List meeting permissions

`GET /meetings/{meeting_id}/permissions`

## Request

- Base URL: `https://api.timeless.day/v1`
- URL: `https://api.timeless.day/v1/meetings/{meeting_id}/permissions`
- Auth: HTTP bearer

List public, teammate, and team permissions for a meeting you own. Includes the share URL.

## Path parameters

- `meeting_id` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Successful response

- MeetingPermissions
  - `data` MeetingPermissionGrant[], required
    - `id` string, required
    - `recipient` union, required
      - AnyoneRecipient
        - `type` 'anyone', required
      - UserRecipient
        - `type` 'user', required
        - `id` string, required
      - TeamRecipient
        - `type` 'team', required
        - `id` string, required
    - `role` 'read' | 'edit', required
  - `next_cursor` string, nullable, required
  - `has_more` boolean, required
  - `share_url` string, required: Meeting link. Its availability depends on the recipient permissions.

## Other responses

- `400`: Invalid ID, pagination, recipient, role, or request body
- `401`: Authentication required
- `403`: API access is not available for this account
- `404`: Meeting not found, not owned by you, or recipient not found in your team
- `429`: Rate limit exceeded

## Changes

- **2026-11-03** `10a43448b654`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/timeless/apis/timeless-public-api/changes/meetings/:meeting_id/permissions/get.md)

---

[API](https://skmtc.dev/timeless/apis/timeless-public-api.md) - [All operations](https://skmtc.dev/timeless/apis/timeless-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/timeless/apis/timeless-public-api/revisions/10a43448b654?raw)