Skip to main content
GET
Get room

Authorizations

Authorization
string
header
required

API token from your Timeless dashboard.

Path Parameters

room_id
string
required

Room ID, for example room_abc123.

Query Parameters

expand
enum<string>[] | null

Expand related resources inline. Supported values: documents, meetings.

Available options:
documents,
meetings

Response

Successful response

id
string
required

Room ID.

Example:

"room_abc123"

title
string
required

Room title.

Example:

"Engineering standups"

created_at
string<date-time>
required

ISO 8601 timestamp.

Example:

"2025-01-01T00:00:00Z"

updated_at
string<date-time>
required

ISO 8601 timestamp.

Example:

"2025-01-15T10:30:00Z"

meeting_count
integer
required

Number of meetings in this room.

Example:

42

share_url
string | null

Link that opens this room in the Timeless app, identical to the one the Share button produces. Sharing settings still apply: recipients can open it only if the room is shared publicly or shared with them. null if the room's owner cannot be resolved.

Example:

"https://my.timeless.day/m/NEhuOGNSdlQ1a013UTJ4QmRKOXBMZTlXbTV0SGNKNnlRbkIzeFZwTDdkR2s="

documents
Document · object[]

Only present when expand=documents is requested.

meetings
MeetingPreview · object[]

Only present when expand=meetings is requested.