---
title: "List room permissions"
method: GET
path: "/rooms/{room_id}/permissions"
tags: ["rooms"]
---

# List room permissions

`GET /rooms/{room_id}/permissions`

## Request

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

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

## Path parameters

- `room_id` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Successful response

- RoomPermissions
  - `data` RoomPermissionGrant[], 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: Room link. Its availability depends on the recipient permissions.

## Other responses

- `400`: Invalid ID or pagination
- `401`: Authentication required
- `403`: API access is not available for this account, or you are not the room owner
- `404`: Room not found or not accessible
- `429`: Rate limit exceeded

## Changes

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

[Operation history](https://skmtc.dev/timeless/apis/timeless-public-api/changes/rooms/:room_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)