TItimeless
rooms

Get room

Changed on

Returns one room you own or that is shared with you.

get/rooms/{room_id}

Request

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

Path parameters

room_idstring required

Room ID, for example room_abc123.

Query parameters

expandRoomExpand[] nullable

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

Response

Successful response

idstring required

Room ID.

titlestring required

Room title.

created_atstring date-time required

ISO 8601 timestamp.

updated_atstring date-time required

ISO 8601 timestamp.

meeting_countinteger required

Number of meetings in this room.

share_urlstring nullable

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 response

{
  "id": "room_abc123",
  "title": "Engineering standups",
  "created_at": "2025-01-01T00:00:00Z",
  "updated_at": "2025-01-15T10:30:00Z",
  "meeting_count": 42,
  "share_url": "https://my.timeless.day/m/NEhuOGNSdlQ1a013UTJ4QmRKOXBMZTlXbTV0SGNKNnlRbkIzeFZwTDdkR2s=",
  "documents": [
    {
      "id": "doc_abc123",
      "title": "Meeting summary",
      "created_at": "2025-01-15T10:35:00Z"
    }
  ],
  "meetings": [
    {
      "id": "mtg_abc123",
      "title": "Weekly standup",
      "start_time": "2025-01-15T10:00:00Z",
      "duration": 1800
    }
  ]
}

Changes