Skip to main content
POST
Create room

Authorizations

Authorization
string
header
required

API token from your Timeless dashboard.

Body

application/json
title
string
required

Room title, 1–100 characters. Leading and trailing whitespace is trimmed.

Required string length: 1 - 100
Example:

"Acme renewal"

Response

Room created

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.