TItimeless
rooms

Create room

Changed on

Create an empty room you own. Add meetings to it with Add meeting to room and share it with Set room permission.

post/rooms

Request

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

Request body

titlestring required

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

Example request

{
  "title": "Acme renewal"
}

Response

Room created

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