Table of Contents

API : Flexcare : Videochat : Update room

Introduction

This endpoints updates a conference room, adds a device or a participant to the room

Request

URL https://api.telecomx.dk/flexcare/videochat/meeting/update
Method POST
Access level RESELLER, ADMIN
Body meeting ObjectId Id of room
type String Enum is it device or participant DEVICE or PARTICIPANT
device Object Device to be added to the room
participant Object Participant to be added to the room

Query example

https://api.telecomx.dk/flexcare/videochat/meeting/update

Response

JSON object
meeting Object The room object
meeting._id ObjectId Unique id of a setting.
meeting.customer ObjectId Id of the customer.
meeting.subject String Medcom, room subject.
meeting.startTime Date Start date and time of room.
meeting.endTime Date End date and time of room..
meeting.description String Medcom, room description.
meeting.uuid String Medcom, Uniq id of a room.
meeting.externalId String Medcom, Uniq external id of a room.
meeting.created Date Date when room is created in TCX.
meeting.startTimeMedcom String Medcom, Start time and date formatted to meet medcom requirments.
meeting.endTimeMedcom String Medcom, End time and date formatted to meet medcom requirments.
meeting.clinicalLink String Medcom, Link created by medcom for applications they have.
meeting.guestDesktopLink String Medcom, weblink for guests.
meeting.hostDesktopLink String Medcom, weblink for hosts.
meeting.mobilLink String Medcom, weblink for mobile devices.
meeting.uri String Medcom, room link for tablets.
meeting.pin String Medcom, pin to access the room.
meeting.state String Medcom, State of room CREATED, STARTED CLOSED, PROVISION_PROBLEMS PROVISIONED_OK, STARTING_TO_DEPROVISION or DEPROVISION_PROBLEMS.
meeting.meetingSetting ObjectId Setting id.
meeting.participants Array List of participants
meeting.participants [].type String Type of invite SMS or EMAIL.
meeting.participants [].value String Number to send sms to or email to mail to.
meeting.participants [].reference String Sms only, reference number of the sms.
meeting.participants [].smsStatus String Status of the sms.
meeting.devices Array List of tablets.
meeting.devices []._id ObjectId Tablet id.
meeting.devices [].name String Tablet name.
meeting.devices [].serial String Tablet serial number.
meeting.devices [].deviceId String Tablet device id.

Example

{
    meeting: {
       _id: ObjectId('1234567890123457890CCCC'),
       subject: 'Årlig sundheds check',
       description: 'Gennemgang af patient forløb',
       startTime: '2025-11-04T10:40:23.223+00:00',
       endTime: '2025-11-04T11:40:23.223+00:00',
       externalId: '88f73951-70a6-47f6-be21-d0be415db9e0',
       uuid: 'c6c5365a-2b3c-44ec-82d6-69cdaef8fbbc',
       customer: ObjectId('1234567890123457890CCCC'),
       uri: 'test@rooms.dk',
       pin: '1234',
       desktopLink: 'https://s.test.dias.rm.dk/QcT',
       clinicalLink: 'https://rooms.dk/webapp/?conference=test@rooms.dk&pin=1234&name=Patient',
       mobileLink: 'https://s.test.dias.rm.dk/YuP',
       state: 'CREATED',
       created: ISODate('2016-01-01T00:00:00.000Z'),
       startTimeMedcom: '2025-11-04T10:40:23 +00:00',
       endTimeMedcom: '2025-11-04T11:40:23 +00:00',
       guestDesktopLink: 'https://portal.vconf.dk/?url=test@rooms.dkk&pin=1234',
       hostDesktopLink; 'https://portal.vconf.dk/?url=test@rooms.dk&pin=1234',
       clinicalLink: '',
       mobilLink: 'https://m.vconf.dk/bb4418ce6323',
       participants: [
          {
              type: 'SMS',
              value: '+4545454545',
              reference: '1234567890123457890CCCC',
              smsStatus: 'Delivered'
          }
      ],
      devices: [
          {
            _id: ObjectId('1234567890123457890CCCC'),
            serial: 'FLXCA1700937',
            name: 'Test',
            deviceId: '1700937',
            settings: {
                 medcomUri: 'https://rooms.dk',
                 cameraOn: false,
                 microphoneOn: true,
                 setVolume: true,
                 addParticipant: false,
                 volume: 80,
                 quality: 'HIGH'
            }
          }
      ]
    }
}

Errors

Error code Message Description
403 token Access denied
404 meeting Meeting not found
404 setting Setting not found
422 Invalid data Data is not valid in query
500 internal_error <Unspecified>