Common Objects

Several services are using similar objects. They are described in this section.

Address Information attributes

Name

Type

Methods

Description

GET

POST

PUT

addressLine1

String

A

O

O

The street, number, box address.

addressLine2

String

A

O

O

The continuation of the address if it must be presented over 2 lines.

city

String

A

O

O

The city.

state

String

A

O

O

The state or province or equivalent notion.

stateDisplayName

String

A

O

O

A display name for the state if needed.

postalCode

String

A

O

O

The postal or zip code.

country

String

A

O

O

The country.

Call Center DNIS List Item

Name

Type

Method

Description

GET

serviceUserId

String

A

name

String

A

Call Center DNIS Instance

Name

Type

Methods

Description

GET

PUT

serviceUserId

String

A

R

The service user id of the call center.

name

String

A

R

The unique name of the DNIS.

Call Center Instance

The presence of the attributes may vary depending on the type of call enter and of the features enabled.

Name

Type

Method

Description

GET

PUT

serviceUserId

String

A

R

The Call Center unique ID.

phoneNumber

String

A

The Phone number.

extension

String

A

The Extension.

available

Boolean

A

O

The status of the call center.

logOffAllowed

Boolean

A

Toggle the logOffAllowed functionality.

name

String

C

The Call Center name. Only in case of enrichCcInfo=true.

type

String

A

The Call Center type.

priority

String

A

The Priority.

routingType

String

C

The Routing Type

skillLevel

String

C

O, C

The Call Center skill level.

Call Center List Item

Name

Type

Method

Description

GET

PUT

serviceUserId

String

A

R

The Call Center unique ID.

name

String

C

The Call Center name. Only in case of enrichCcInfo=true.

User Voice Messaging

User Voice Messaging Basic attributes

Name

Type

Methods

Description

GET

PUT

active

Boolean

A

O

The status of the service.

processing

String

A

O

voiceMessageDeliveryEmailAddress

String

A

O

usePhoneMessageWaitingIndicator

Boolean

A

O

sendVoiceMessageNotifyEmail

Boolean

A

O

voiceMessageNotifyEmailAddress

String

A

O

sendCarbonCopyVoiceMessage

Boolean

A

O

voiceMessageCarbonCopyEmailAddress

String

A

C

transcribe

Boolean

C

O

Enable Voice Mail transcription that will be sent to the addresses defined in transcribeEmailAddresses, needs transcribe feature assigned.

transcribeEmailAddresses

Arrray

C

O

List of email addresses where the transcription of the email will be sent.

transferOnZeroToPhoneNumber

Boolean

A

O

transferPhoneNumber

String

A

O

alwaysRedirectToVoiceMail

Boolean

A

O

busyRedirectToVoiceMail

Boolean

A

O

noAnswerRedirectToVoiceMail

Boolean

A

O

outOfPrimaryZoneRedirectToVoiceMail

Boolean

A

O

User Voice Messaging Advanced attributes

Name

Type

Methods

Description

GET

PUT

mailServerSelection

String

O

O

The type of the mail server. Default Group.

groupMailServerEmailAddress

String

C

OC

The Group mail server address.

groupMailServerUserId

String

C

OC

The Group mail server user id.

groupMailServerPassword

String

C

OC

The Group mail server password.

mailboxLimit

String

Integer

C

OC

The Group mailbox limit. String value from “useGroupSetting”.

personalMailServerNetAddress

String

C

OC

The Personal mail server address.

personalMailServerProtocol

String

C

OC

The Personal mail server protocol.

personalMailServerRealDeleteForImap

Boolean

C

OC

The Personal mail server real delete for IMAP.

personalMailServerEmailAddress

String

C

OC

The Personal mail server address.

personalMailServerUserId

String

C

OC

The Personal mail server user id.

personalMailServerPassword

String

C

OC

The Personal mail server password.

User Voice Messaging Announcements attributes

Name

Type

Methods

Description

GET

PUT

disableMessageDeposit

Boolean

A

O

disableMessageDepositAction

String

A

O

greetingOnlyForwardDestination

String

A

O

Phone Number or SIP URI that can be used to dial.

busyAnnouncementSelection

Boolean

A

O

busyPersonalAudioFile

Object/String

A

O

An object as defined in Announcement File Name or an empty string to unassign the announcement.

noAnswerNumberOfRings

Integer

A

O

extendedAwayEnabled

Boolean

A

O

extendedAwayDisableMessageDeposit

Boolean

A

O

extendedAwayAudioFile

Object/String

A

O

An object as defined in Announcement File Name or an empty string to unassign the announcement.

noAnswerAnnouncementSelection

String

A

O

noAnswerPersonalAudioFile

Object/String

A

O

An object as defined in Announcement File Name or an empty string to unassign the announcement.

noAnswerAlternateGreeting01

Object

A

O

An object as defined in Voice Messaging Alternate No Answer Greeting.

noAnswerAlternateGreeting02

Object

A

O

An object as defined in Voice Messaging Alternate No Answer Greeting.

noAnswerAlternateGreeting03

Object

A

O

An object as defined in Voice Messaging Alternate No Answer Greeting.

Voice Messaging Alternate No Answer Greeting

Name

Type

Methods

Description

GET

PUT

name

String

A

R

audioFile

Object

A

R

An object as defined in Announcement File Name.

Call Forwarding attributes

Name

Type

Methods

Description

GET

PUT

active

Boolean

A

O

The status of the service.

destination

String

A

O

The destination.

ringSplashActive

Boolean

A

O

numberOfRings

Integer

A

O

Services Summary attributes

Name

Type

Method

Description

GET

userServices

Array

A

A list of objects as defined in Service Summary attributes. Returned if relevant.

groupService

Array

A

A list of objects as defined in Service Summary attributes. Returned if relevant.

Services Assignment Status attributes

Name

Type

Method

Description

GET

userServices

Array

O

A list of objects as defined in Service Assignment Status attributes. Returned if relevant.

groupService

Array

O

A list of objects as defined in Service Assignment Status attributes. Returned if relevant.

Service Assignment Status attributes

Name

Type

Methods

Description

GET

POST

DELETE

name

String

A

R

R

The name of the service.

assigned

Boolean

A

F

F

The status assigned of the service.

Phone List attributes

Name

Type

Methods

Description

GET

POST

PUT

DELETE

name

String

A

R

O

R

See name from Phone List attributes.

phoneNumber

String

A

R

O

F

See phoneNumber from Phone List attributes.

Criteria in List attributes

Name

Type

Method

Description

GET

name

String

A

The name of the criteria

active

Boolean

A

The status of the criteria

callsFrom

String

A

Text representation of fromDnCriteria

fromDnCriteria

Object

A

An object as defined as Criteria From DN attributes

doNotPerformAction

Boolean

C

Used to define a period of time/people that will be excluded from the main criteria For example one is “reject all calls during lunch time” and second one is “never if my boss”. Not relevant for forwarding service as forwardToNumberSelection is used instead.

timeScheduleObj

Object

O

A schedule object as defined as Schedule attributes.

timeSchedule

String

O

The schedule name with, at the end, between parenthesis the level if not the default one

holidaySchedule

Object

O

A schedule object as defined as Schedule attributes.

holidayScheduleObj

String

O

The schedule name with, at the end, between parenthesis the level if not the default one

Criteria attributes

Name

Type

Methods

Description

GET

PUT

POST

DELETE

name

String

A

R

R

R

The name of the criteria

newName

String

F

O

F

F

The new name of the criteria. Only update

active

Boolean

A

O

O

F

The status of the criteria

fromDnCriteria

Object

A

O

R

F

An object as defined as Criteria From DN attributes

doNotPerformAction

Boolean

C

O

O

F

Used to define a period of time/people that will be excluded from the main criteria For example one is “reject all calls during lunch time” and second one is “never if my boss”. Not relevant for forwarding service as forwardToNumberSelection is used instead.

timeSchedule

Object

O

O

O

F

A schedule object as defined as Schedule attributes. In a PUT, Null to remove.

holidaySchedule

Object

O

O

O

F

A schedule object as defined as Schedule attributes. In a PUT, Null to remove.

Criteria attributes for Call Forwarding Selective

The criteria is the combination of the generic criteria (Criteria attributes or Criteria in List attributes) and specific attributes for this service.

Name

Type

Methods

Description

GET

PUT

POST

DELETE

forwardToPhoneNumber

String

C

O

O

F

The specific forwarding number you want to use for this entry.

forwardToNumberSelection

String

A

O

O

F

Specify the type of forwarding for the call, Allowed values: “Forward To Specified Number”, “Forward To Default Number” and “Do not forward”

Criteria attributes for Custom Ring Back

The criteria is the combination of the generic criteria (Criteria attributes or Criteria in List attributes) and specific attributes for this service.

Name

Type

Methods

Description

GET

PUT

POST

DELETE

audioSelection

String

A

O

O

F

Specify the source of the custom ring back for normal calls.

audioFile

Object

A

O

O

F

An object as defined in Announcement File Name. With default level ‘User’.

callWaitingAudioSelection

String

A

O

O

F

Specify the source of the custom ring back for the calls handled by the call waiting feature.

callWaitingAudioFile

Object

A

O

O

F

An object as defined in Announcement File Name. With default level ‘User’.

Criteria attributes for Executive and Executive Assistant

The criteria is the combination of the generic criteria (Criteria attributes) and specific attributes for this service.

Name

Type

Methods

Description

GET

PUT

POST

DELETE

filter

Boolean

A

O

O

F

True to route calls to executive assistants, false Otherwise.

Schedule attributes

Name

Type

Methods

Description

GET

PUT

POST

level

String

A

O

R

The level of the schedule. If not provided, a default value from API level. Allowed values are Tenant, Group and User

name

String

A

R

R

The name of the schedule.

Criteria From DN attributes

Indicate which calls will activate the criteria.

Name

Type

Methods

Description

GET

PUT

POST

selection

String

A

O

R

Indicate which numbers will activate the criteria : “Any” (all numbers, the other parameters are ignored) or “Specified Only” (the other attributes are taken into account). In case of Selective Call Rejection service an additional value is possible “Forwarded”. In case of Priority Alerting the value “Any” is replaced by “Any External”.

includeAnonymousCallers

Boolean

A

O

R

If set, all calls from private numbers will activate the criteria.

includeUnavailableCallers

Boolean

A

O

R

If set, all calls from unavailable numbers will activate the criteria.

phoneNumbers

Array

A

C

C

A list of DN (see Phone Number). The old list will be overwrited. An empty list will delete data. List can’t be empty if ‘selection’ value is set to ‘Specified Only’. Only in PUT: if ‘selection’ field is set to ‘Specified Only’ and if the actual criteria instance already has a phoneNumbers list set, then the ‘phoneNumbers’ field list can be not present (the list will not be overwrited).

Location attributes

Name

Type

Methods

Description

GET

POST

PUT

DELETE

id

integer

A

R

R

R

The unique ID of the location.

phoneNumber

string

A

R

R

O

The phone number (if configured, empty or absent otherwise) (See Phone Number).

numberOfRings

integer

A

O

O

O

The number of rings for the destination

answerConfirmationRequired

boolean

A

O

O

O

If set, the answering party must enter a confirmation digit to complete the call.

Registrations attributes

Name

Type

Method

Description

GET

deviceLevel

String

A

The level of the device

deviceName

String

A

The unique name of the device.

order

String

A

TODO

URI

String

A

TODO

expiration

String

O

The expiration date of the registration, if one is defined.

linePort

String

A

The line port associated to the registration.

endpointType

String

A

The indication if it is a Primary device or a secondary device (Shared Call Appearance).

publicNetAddress

String

A

The public net address of the device.

publicPort

String

A

TODO

PrivateNetAddress

String

A

The private net address of the device.

PrivatePort

String

A

TODO

UserAgent

String

A

The SIP User Agent registered by the device.

LockoutStarted

String

A

TODO

LockoutExpires

String

A

TODO

LockoutCount

String

A

TODO

Criteria in list

Name

Type

Method

Description

GET

active

Boolean

A

The status of the criteria.

name

String

A

The name of the criteria.

timeSchedule

String

A

The name of the schedule.

timeScheduleObj

Object

O

A schedule object as defined as Schedule attributes.

holidaySchedule

String

A

The name of the schedule.

holidayScheduleObj

String

O

The schedule name with, at the end, between parenthesis the level if not the default one

callsFrom

String

A

Text representation of fromDnCriteria

doNotPerformAction

Boolean

A

A boolean flag to indicate to not preform the priority alerting.

fromDnCriteria

Object

A

An object as defined as Criteria From DN attributes

callToNumbers

Array

C

An array of objects as defined as Call To Number attributes. Only returned from Rel21. In Rel22 only returned in AS data mode.

Call To Number attributes

Name

Type

Methods

Description

GET

PUT

POST

type

String

A

R

R

The value comes from list: {‘Primary’|’Alternate1’|’Alternate2’|’Alternate3’|’Alternate4’|’Alternate5’|’Alternate6’|’Alternate7’|’Alternate8’|’Alternate9’|’Alternate10’|’BroadWorks Mobility’}.

number

String

C

C

C

The value of the phone number for the corresponding type, when the number is available. i.e. Alternate 1 may have extension, but no number.

extension

String

C

C

C

The value of the extension for the corresponding Calls To Type, when the extension is available. i.e. Primary may have number, but no extension. For Mobility Calls To Type, this is always blank.

User Device Extra Endpoint Attributes

Name

Type

Method

Description

GET

deviceName

String

A

The name of the device.

deviceType

String

A

The type of the device.

deviceOwner

String

A

The user owner of the device.

deviceUsage

String

A

The type of the device: value from “APP”, “PHONE”.

_description

String

A

The description “extra-own-device-” followed by a number indicates the number of the extra device. NOTE: for internal user only. An other format can be configured via the settings PATTERN_USER_EXTRA_OWN_DEVICE but only 1 is supported in a deployement

extra_phone_id

Integer

A

The etxra_phone_id (extracted for the data generatred from it).

linePort

String

A

The line port associated to this device.

User Device Extra Line Attributes

Name

Type

Method

Description

GET

userId

String

A

The userId of the user who has duplicated his line on this phone.

linePort

String

A

The linePort of this extra line.

firstName

String

A

The first name of the user who has duplicated his line on this phone.

lastName

String

A

The last name of the user who has duplicated his line on this phone.

phoneNumber

String

O

The phone number of the user who has duplicated his line on this phone.

department

Object

O

The department of the user who has duplicated his line on this phone.

order

Integer

A

The order of the extra line.

User Device Add Extra Line Result Attributes

Name

Type

Description

userId

String

The userId of the user who’s line has been replicated on this phone.

status

String

The status of the add line operation : one of “SUCCESS” or “FAILED”.

data

Object

In case of success, the same data as in the result of Create an Additional Phone for a User.

reason

String

In faire of failure, the reason of the failure.

error

Object

In faire of failure, the error object such as in a regular API answer.

Announcement File Name

Name

Type

Methods

Description

GET

PUT

name

String

A

R

The name of an existing announcement. You may use keyword DELETE to suppress an existing announcement.

mediaType

String

A

O

The media type of the announcement.

Supervised Agent

Name

Type

Methods

Description

GET

POST

PUT

DELETE

userId

string

A

R

R

R

The user id of the supervised agent.

lastName

string

A

F

F

F

The last name of the supervised agent.

firstName

string

A

F

F

F

The first name of the supervised agent.

phoneNumber

string

C

F

F

F

The phone number (if configured, empty or absent otherwise).

extension

string

C

F

F

F

The extension (if configured, empty or absent otherwise).

department

string

C

F

F

F

The department of the supervised agent. (if configured, empty or absent otherwise) (See Group department key attributes).

emailAddress

string

C

F

F

F

The email address of the supervised agent (if configured, empty or absent otherwise).

impId

string

C

F

F

F

The imp id of the supervised agent (if configured, empty or absent otherwise).

locationCode

string

C

F

F

F

The location code of the supervised agent (if configured, empty or absent otherwise).

Meet-Me Conferencing Bridge Instance in list

Name

Type

Method

Description

GET

bridgeId

String

A

Unique name for the conference bridge.

name

String

A

The name of the conference bridge.

phoneNumber

String

A

Phone number.

extension

String

A

The extension.

allocatedPorts

Object

A

Number of conference ports allocated to the bridge. Can either be unlimited or limited, see Group meet me conferencing ports attributes.

active

String

A

Specify if the conference bridge is active.

Schedule recurrence attributes

Name

Type

Methods

Description

GET

PUT

POST

recurInterval

Integer

C

C

C

Specify the frequency of occurrence in days.

Schedule recurrence attributes

Name

Type

Methods

Description

GET

PUT

POST

recurInterval

Integer

C

C

C

Specify the frequency of occurrence in weeks.

Sunday

Boolean

A

R

R

Specify the day or days of the week on which the conference should run.

Monday

Boolean

A

R

R

Specify the day or days of the week on which the conference should run.

Tuesday

Boolean

A

R

R

Specify the day or days of the week on which the conference should run.

Wednesday

Boolean

A

R

R

Specify the day or days of the week on which the conference should run.

Thursday

Boolean

A

R

R

Specify the day or days of the week on which the conference should run.

Friday

Boolean

A

R

R

Specify the day or days of the week on which the conference should run.

Saturday

Boolean

A

R

R

Specify the day or days of the week on which the conference should run.

Recur monthly by day attributes

Name

Type

Methods

Description

GET

PUT

POST

recurInterval

Integer

C

C

C

Specify the frequency of occurrence in months.

dayOfMonth

Integer

A

R

R

Specify to schedule the conference on a specific day of the month, for example the 27th. Must be a number within the range 1 to 31.

Recur monthly by week attributes

Name

Type

Methods

Description

GET

PUT

POST

recurInterval

Integer

C

C

C

Specify the frequency of occurrence in months.

dayOfWeekInMonth

String

A

R

R

Specify to schedule the conference on a specific day of the week within the month, for example the Second Monday of the month. Select here the week in month, a value from list: {‘First’|’Second’|’Third’|’Fourth’|’Last’}.

dayOfWeek

String

A

R

R

Specify to schedule the conference on a specific day of the week within the month, for example the Second Monday of the month. Select here the day in the week, a value from list: {‘Sunday’|’Monday’|’Tuesday’|’Wednesday’|’Thursday’|’Friday’|’Saturday’}.

Recur yearly by day attributes

Name

Type

Methods

Description

GET

PUT

POST

recurInterval

Integer

C

C

C

Specify the frequency of occurrence in years.

dayOfMonth

Integer

A

R

R

Specify to schedule the conference on a specific day of the year. Define here the day in the month: a number within the range 1 to 31.

month

String

A

R

R

Specify to schedule the conference on a specific day of the year. Define here the month. A value from list: {‘January’|’February’|’March’|’April’|’May’|’June’|’July’|’August’|’September’|’October’|’November’|’December’}.

Recur yearly by week attributes

Name

Type

Methods

Description

GET

PUT

POST

recurInterval

Integer

C

C

C

Specify the frequency of occurrence in years.

dayOfWeek

Integer

A

R

R

Specify to schedule the conference on a specific day of the week and month, for example the first Sunday of January. Select here the day of week, a value from list: {‘Sunday’|’Monday’|’Tuesday’|’Wednesday’|’Thursday’|’Friday’|’Saturday’}.

dayOfWeekInMonth

Integer

A

R

R

Specify to schedule the conference on a specific day of the week and month, for example the first Sunday of January. Select here the week in the month, a value from list: {‘First’|’Second’|’Third’|’Fourth’|’Last’}.

month

Integer

A

R

R

Specify to schedule the conference on a specific day of the week and month, for example the first Sunday of January. Select here month in the year, a value from list: {‘January’|’February’|’March’|’April’|’May’|’June’|’July’|’August’|’September’|’October’|’November’|’December’}.

Schedule recurrence attributes

Name

Type

Methods

Description

GET

PUT

POST

recurDaily

Object

A

C

R

Daily recurrence and specify the frequency of occurrence in days. Mutually exclusive with: {‘recurWeekly’, ‘recurMonthlyByDay’, ‘recurMonthlyByWeek’, ‘recurYearlyByDay’, ‘recurYearlyByWeek’}

recurWeekly

Object

C

C

C

Weekly recurrence and specify the frequency of occurrence in weeks, and the day or days of the week on which the conference should run. Mutually exclusive with: {‘recurDaily’, ‘recurMonthlyByDay’, ‘recurMonthlyByWeek’, ‘recurYearlyByDay’, ‘recurYearlyByWeek’}

recurMonthlyByDay

Object

C

C

C

Monthly recurrence and specify to schedule the conference on a specific day of the month. Mutually exclusive with: {‘recurDaily’, ‘recurWeekly’, ‘recurMonthlyByWeek’, ‘recurYearlyByDay’, ‘recurYearlyByWeek’}

recurMonthlyByWeek

Object

C

C

C

Monthly recurrence and specify to schedule the conference on a specific day of the week within the month. Mutually exclusive with: {‘recurDaily’, ‘recurWeekly’, ‘recurMonthlyByDay’, ‘recurYearlyByDay’, ‘recurYearlyByWeek’}

recurYearlyByDay

Object

C

C

C

Yearly recurrence and specify to schedule the conference on a specific day of the year. Mutually exclusive with: {‘recurDaily’, ‘recurWeekly’, ‘recurMonthlyByDay’, ‘recurMonthlyByWeek’, ‘recurYearlyByWeek’}

recurYearlyByWeek

Object

C

C

C

Yearly recurrence and specify to schedule the conference on a specific day of the week and month. Mutually exclusive with: {‘recurDaily’, ‘recurWeekly’, ‘recurMonthlyByDay’, ‘recurMonthlyByWeek’, ‘recurYearlyByDay’}

recurForEver

Boolean

C

C

C

Specify if the conference should recur continuously or not. Mutually exclusive with: {‘recurEndDate’, ‘recurEndOccurrence’}

recurEndDate

Date

C

C

C

Specify to end the conference on a specific date. Format “%Y-%m-%d”, example: “2025-09-09”. Mutually exclusive with: {‘recurForEver’, ‘recurEndOccurrence’}

recurEndOccurrence

Integer

C

C

C

Specify to end the conference after specified number of occurrences. Mutually exclusive with: {‘recurForEver’, ‘recurEndDate’}

Meet-Me Conferencing Conference schedule reservationLess

Name

Type

Methods

Description

GET

PUT

POST

startTime

DateTime

A

C

R

The conference start date and time. Format rfc3339, example: “2024-08-01T11:00:00.000+02:00”.

endTime

DateTime

C

C

C

The conference end date and time. Format rfc3339, example: “2024-08-01T11:00:00.000+02:00”. If not provided, the conference will not have an end date.

Meet-Me Conferencing Conference schedule one time

Name

Type

Methods

Description

GET

PUT

POST

startTime

DateTime

A

C

R

The conference start date and time.

duration

Object

C

C

C

The conference duration. See Conference duration.

Meet-Me Conferencing Conference schedule recurring

Name

Type

Methods

Description

GET

PUT

POST

startTime

DateTime

A

C

R

The conference start date and time. Format rfc3339, example: “2024-08-01T11:00:00.000+02:00”.

duration

Object

C

C

C

The conference duration. See Conference duration.

recurrence

Object

C

C

R

Specify the recurrence pattern. See Schedule recurrence attributes.

Meet-Me Conferencing Conference Schedule

Name

Type

Methods

Description

GET

PUT

POST

scheduleReservationless

Object

C

C

C

Set the conference type to ‘Reservationless’. See Meet-Me Conferencing Conference schedule reservationLess. Mutually exclusive with: {‘scheduleOneTime’, ‘scheduleRecurring’}.

scheduleOneTime

Object

C

C

C

Set the conference type to ‘One Time’. See Meet-Me Conferencing Conference schedule one time. Mutually exclusive with: {‘scheduleReservationless’, ‘scheduleRecurring’}.

scheduleRecurring

Object

C

C

C

Set the conference type to ‘Recurring [‘Daily’|’Weekly’|’Monthly’|’Yearly’]’. See Meet-Me Conferencing Conference schedule recurring. Mutually exclusive with: {‘scheduleReservationless’, ‘scheduleOneTime’}.

Meet-Me Conferencing Conference Instance in list

Name

Type

Method

Description

GET

bridgeId

String

A

Unique Id for the conference bridge.

conferenceId

String

A

Unique Id for the conference.

title

String

A

The conference title.

bridgeName

String

A

The bridge name.

status

String

A

The conference status. Can be ‘active’, ‘inactive’ or ‘expired’.

type

String

A

Specify the conference type. Can be ‘Reservationless’, ‘One Time’, ‘Recurring Daily’, ‘Recurring Weekly’, ‘Recurring Monthly’ or ‘Recurring Yearly’.

startTime

DateTime

A

Start Time is in the format “yyyy-MM-dd’T’HH:mm:ss:SSSZ”. Example: 2010-10-01T09:30:00:000-0400.

lastName

String

A

The user last name.

firstName

String

A

The user first name.

hostId

String

A

The Id of the conference host.

Meet-Me Conferencing Conference Instance

Name

Type

Methods

Description

GET

PUT

POST

title

String

A

C

R

The conference title.

estimatedParticipants

Integer

C

C

C

The number of participants the conference may have. Can’t be higher than the maximum number of ports available on the bridge on which this conference is hosted.

restrictParticipants

Boolean

C

C

R

Specify if to set a maximum number of participants to the conference.

maxParticipants

Integer

C

C

R

If ‘restrictParticipants’ is true, specify the maximum number of participants the conference can have. Can’t be higher than the maximum number of ports available on the bridge on which this conference is hosted.

accountCode

String

C

C

C

The account code to use for the conference.

muteAllAttendeesOnEntry

Boolean

A

C

R

If this option is enabled, all attendees will be muted on entry. For conferences with more than 147 attendees: attendees are muted on entry.

endConferenceOnModeratorExit

Boolean

A

C

R

If this option is enabled, the conference will be ended when host departs.

moderatorRequired

Boolean

A

C

R

If this option is enabled, the moderator is required to start the conference.

requireSecurityPin

Boolean

A

C

R

Specify if to enable the security pin to access the conference.

securityPin

String

C

F

F

The security pin to provide if ‘requireSecurityPin’ is enabled. Conditionally returned: only if the security pin is required for this conference.

allowUniqueIdentifier

Boolean

A

C

R

Allow unique identifier.

attendeeNotification

String

A

C

R

Specify how to notify the conference attendees when other attendees join or leave the conference. The value is one of: ‘Play Tone’, ‘Play Recorded Name’, ‘No Notification’. For conferences with more than 147 attendees: the entry/exit tones and name announcements are disabled.

conferenceSchedule

Object

A

C

R

Specify the type of conference you want to create. Select One Time, Recurring, or Reservationless. See Meet-Me Conferencing Conference Schedule.

moderatorPin

String

A

F

F

The moderator pin code.

hostTimeZone

String

A

F

F

The time zone of the host.

Conference greeting announcement

Name

Type

Methods

Description

GET

PUT

name

String

A

R

The announcement name.

mediaType

String

A

C

The announcement media type. If not provided, the default media type will be used.

Conference delete recording item

Name

Type

Method

Description

DELETE

bridgeId

String

R

The bridge id.

conferenceId

String

R

The conference id.

startTime

DateTime

R

The conference start time. Format rfc3339, example: “2020-08-01T11:00:00.000+02:00”.

Conference Delegate item

Name

Type

Methods

Description

GET

PUT

userId

String

A

R

Unique name for the user.

firstName

String

A

F

User’s first name.

lastName

String

A

F

User’s last name.

phoneNumber

String

A

F

Phone number.

extension

String

A

F

The extension.

department

Object

A

F

An object as defined as Group department key attributes.

emailAddress

String

A

F

User’s email address.

User common object

Name

Type

Method

Description

GET

userId

String

A

Unique name for the user.

firstName

String

A

User’s first name.

lastName

String

A

User’s last name.

phoneNumber

String

A

Phone number.

extension

String

A

The extension.

department

Object

A

Uniquely identifies a department system-wide. An object as defined as Group department key attributes.

emailAddress

String

A

User’s email address.

Devices To Ring

Name

Type

Methods

Description

GET

PUT

POST

mode

String

A

O

R

Specifies the alerting policy mode. A value from list: [‘Fixed’,’Mobile’,’Both’}. Fixed: to ring fixed devices for calls to this mobile number, check also one or more of the following options to specify which devices to ring: ‘includeSharedCallAppearance’, ‘includeAnywhere’. Mobile: to ring mobile devices for calls to this mobile number and add one or more alerted mobile numbers. Both: to ring both fixed and mobile devices. Inherit above behaviours.

includeSharedCallAppearance

Boolean

A

O

R

Specifies if to ring the Shared Call Appearance devices.

includeAnywhere

Boolean

A

O

R

Specifies if to ring the Anywhere devices.

includeExecutiveAssistant

Boolean

A

O

R

Specifies if to ring the Executive Assistant devices.

mobilesNumbers

Array

A

O

O

A list of the alerted mobile numbers. An array of items as defined as User alerted mobile number. Replacement list for PUT request.

User identity mobile number

Name

Type

Method

Description

GET

mobileNumber

String

A

Mobile number.

description

String

A

The description of the mobile number.

countryCode

String

A

The country code of the number.

nationalPrefix

String

A

The prefix used for national numbers.

primary

String

A

Specify if it is the primary mobile number.

enableAlerting

String

A

Specify if the mobile number is enabled for alerting.

User alerted mobile number

Name

Type

Method

Description

GET

PUT

POST

mobileNumber

String

A

R

R

Mobile number to be alerted.

countryCode

String

A

F

F

The country code of the number.

nationalPrefix

String

A

F

F

The prefix used for national numbers.

Flexible seating available host attributes

Name

Type

Method

Description

GET

serviceUserId

String

A

The host user id.

lastName

String

A

The host last name.

firstName

String

A

The host first name.

phoneNumber

String

A

The host phone number.

extension

String

A

The host extension.

department

Object

A

The host department. An object as defined as Group department key attributes.

emailAddress

String

A

The host email address.

associationLimitHours

Integer

A

Specifies the host association limit in hours.

enableAssociationLimit

Boolean

A

Specifies if the host has an association time limit, time limit is defined in hostAssociationLimitHours.

Advanced Flexible seating available host attributes

Name

Type

Method

Description

GET

serviceUserId

String

A

Uniquely identifies a flexible seating host.

name

String

A

The flexible seating host name.

cliLastName

String

C

The calling line id flexible seating host last name.

cliFirstName

String

C

The calling line id flexible seating host first name.

phoneNumber

String

A

The flexible seating host phone number.

extension

String

A

The flexible seating host extension.

department

object

A

The assigned department. An object as defined as Group department key attributes.

language

String

C

The flexible seating host language.

timeZone

String

C

The flexible seating host timeZone.

timeZoneDisplayName

String

C

The flexible seating host timeZone display name.

defaultAlias

String

C

The flexible seating host default alias.

aliases

array

C

The flexible seating host aliases. An array of strings identifying aliases.

publicUserIdentity

String

C

The flexible seating host public user identity.

cliPhoneNumber

String

C

The calling line id flexible seating host phone number.

password

String

C

The flexible seating host password.

endpoint

object

C

The flexible seating host endpoint. An object as defined as Access Device Endpoint for Flexible Seating.

networkClassOfService

String

C

The flexible seating host network class of service.

active

String

A

Specifies if the flexible seating host is active.

guestInfo

String

C

The guest info. An object as defined as Flexible Seating Guest Info.

Call Anchoring

Name

Type

Methods

Description

GET

PUT

POST

enableCallAnchoring

Boolean

A

O

R

Specifies if to enable call anchoring.

timeSchedule

Object

C

O

O

Excluded Time Schedule. A schedule object as defined as Schedule attributes.

holidaySchedule

Object

C

O

O

Excluded Holiday Schedule. A schedule object as defined as Schedule attributes.

Feature Access Code

Name

Type

Method

Description

GET

PUT

name

String

A

R

Feature Access Code Name

code

String

A

F

Feature Access Code

alternateCode

String

C

F

Alternative Feature Access Code.

enabled

Boolean

A

O

Specify if Feature Access Code is enabled or not