Cisco Cisco TelePresence Management Suite (TMS) Version 15 Developer's Guide

Booking API reference 

Cisco TMS Extension Booking API Programming Reference Guide (13.0.1) 

Page 18 of 33 

 

 

ConferenceId  

r/w - optional, if not 
specified -1 is assumed 

Initially set to -1 to state to the saveconference method that the 
conference needs to be created. If set to a value greater than 
0, the existing conference with the given ID is replaced with the 
conference specified. 

Title  

r/w - optional 

If none specified the default name as defined in the 
Administrator Tools Page in Cisco TMS is used 

StartTimeUTC  

r/w - required 

The start time of the conference in UTC format. See 

 for more information. 

Only UTC times are supported (e.g. ending in a Z). Example: 
1975-06-01T23:32:11Z. 

EndTimeUTC  

r/w - required 

The end time of the conference in UTC format. See 

 for more information. 

Only UTC times are supported (e.g. ending in a Z). Example: 
1975-06-01T23:32:11Z. 

RecurrenceInstance
IdUTC  

r - only used when getting 
conference from Cisco TMS 

Gives the start date of the instance of the meeting according to 
the recurrence pattern. If this is different from starttimeutc, the 
meeting is an exception to the recurrence pattern. 

RecurrenceInstance
Type  

r - only used when getting 
conference from Cisco TMS 

If this string contains the value ‘modify’  it means that the 
particular meeting is an exception to a recurrence pattern. It 
the string contains ‘deleted’, it is a meeting that has been 
deleted from a series of recurring meetings. 

FirstOccurrenceRecI
nstanceIdUTC   

r - only used when getting 
conference from Cisco TMS 

Gives the start date of first instance of the meeting according 
to the recurrence pattern. If this is different from starttimeutc, 
the first meeting of the series is an exception to the recurrence 
pattern. 

RecurrencePattern  

r/w – optional 

Sets the recurrence patterns for recurrent meetings. This is not 
valid if you call the ‘saveconferencerecinstance’ method. 

OwnerId  

r/w - optional 

The user ID of the owner of the conference. This is typically not 
set by the external booking API, but by Cisco TMS. If no owner 
is specified the user authenticated to the webservice is used.  
IDs of users existing in Cisco TMS can be found in the acluser 
table of the Cisco TMS database. 

OwnerUserName  

w - optional 

The username of the person booking the conference. This is 
used by Cisco TMS to lookup the ownerid in the Cisco TMS 
database. If no owner is specified the user authenticated to the 
webservice is used. If ownerid is specified, it will be used 
instead of this field. 

OwnerFirstName/O
wnerLastName/Own
erEmailAddress 

w - optional 

The first and last name of the owner of the conference. This is 
used by Cisco TMS to look-up the ownerid in the Cisco TMS 
database. If no owner is specified the user authenticated to the 
webservice is used. If ownerusername or ownerid is used 
instead of this field, those fields will be used instead of this 
field.