User Operations
This section documents the API operations for User service.
AddUser
AddUser
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Add extension: request
Properties
| Property | Value |
|---|---|
| content | complex |
Extends
Base type: userData:UserInfo
Elements
| Element | Type | Description |
|---|---|---|
| accountData:templateID | accountData:templateID (optional) | |
| accountData:verbose | accountData:verbose (optional) | |
| accountData:notifyOnly | accountData:notifyOnly (optional) | |
| common:scope | common:scope (optional) | |
| otherNotifyEmail | common:email (optional) | The email address where to send email when a new account is created; usually used in automation. |
| accountData:dku | accountData:dku (optional) | |
| accountData:accountFlag | accountData:accountFlag (0..*) | |
| (choice) | One of the following | |
| └ accountData:parentID | accountData:parentID | |
| └ accountData:parentIdentifier | accountData:parentIdentifier | |
| └ accountData:parentLogin | accountData:parentLogin |
XSD Source
<xs:element name="AddUser">
<xs:annotation>
<xs:documentation>Add extension: request</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:complexContent>
<xs:extension base="userData:UserInfo">
<xs:sequence>
<xs:element name="accountData:templateID" type="accountData:templateID" minOccurs="0"/>
<xs:element name="accountData:verbose" type="accountData:verbose" minOccurs="0"/>
<xs:element name="accountData:notifyOnly" type="accountData:notifyOnly" minOccurs="0"/>
<xs:element name="common:scope" type="common:scope" minOccurs="0"/>
<xs:element name="otherNotifyEmail" type="common:email" minOccurs="0">
<xs:annotation>
<xs:documentation>The email address where to send email when a new account is created; usually used in automation.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="accountData:dku" type="accountData:dku" minOccurs="0"/>
<xs:element name="accountData:accountFlag" type="accountData:accountFlag" minOccurs="0" maxOccurs="unbounded"/>
<xs:choice>
<xs:element name="accountData:parentID" type="accountData:parentID" minOccurs="0"/>
<xs:element name="accountData:parentIdentifier" type="accountData:parentIdentifier" minOccurs="0"/>
<xs:element name="accountData:parentLogin" type="accountData:parentLogin" minOccurs="0"/>
</xs:choice>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>AddUserResponse
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Add extension: response
Properties
| Property | Value |
|---|---|
| content | complex |
Extends
Base type: userData:ExtendedUserInfo
Elements
| Element | Type | Description |
|---|---|---|
| accountData:chargingPlanID | accountData:chargingPlanID (optional) | |
| accountData:chargingPlanIdentifier | accountData:chargingPlanIdentifier (optional) | |
| common:result | common:result (optional) | |
| common:notice | common:notice (0..*) | |
| accountData:template | accountData:template (optional) |
XSD Source
<xs:element name="AddUserResponse">
<xs:annotation>
<xs:documentation>Add extension: response</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:complexContent>
<xs:extension base="userData:ExtendedUserInfo">
<xs:sequence>
<xs:element name="accountData:chargingPlanID" type="accountData:chargingPlanID" minOccurs="0"/>
<xs:element name="accountData:chargingPlanIdentifier" type="accountData:chargingPlanIdentifier" minOccurs="0"/>
<xs:element name="common:result" type="common:result" minOccurs="0"/>
<xs:element name="common:notice" type="common:notice" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="accountData:template" type="accountData:template" minOccurs="0"/>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>EditUser
EditUser
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Edit extension: request
Properties
| Property | Value |
|---|---|
| content | complex |
Extends
Base type: userData:UserInfo
Elements
| Element | Type | Description |
|---|---|---|
| (choice) | One of the following | |
| └ common:ID | common:ID | |
| └ common:identifier | common:identifier |
XSD Source
<xs:element name="EditUser">
<xs:annotation>
<xs:documentation>Edit extension: request</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:complexContent>
<xs:extension base="userData:UserInfo">
<xs:sequence>
<xs:choice>
<xs:element name="common:ID" type="common:ID" minOccurs="0"/>
<xs:element name="common:identifier" type="common:identifier" minOccurs="0"/>
</xs:choice>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>EditUserResponse
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Edit extension: response
Properties
| Property | Value |
|---|---|
| content | complex |
Extends
Base type: common:updateObject
XSD Source
<xs:element name="EditUserResponse">
<xs:annotation>
<xs:documentation>Edit extension: response</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:complexContent>
<xs:extension base="common:updateObject">
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>SetUserStatus
SetUserStatus
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Change extension status:request
Properties
| Property | Value |
|---|---|
| content | complex |
Elements
| Element | Type | Description |
|---|---|---|
| accountData:status | accountData:status (optional) | |
| accountData:phoneStatus | accountData:phoneStatus (optional) | |
| common:scope | common:scope (optional) | |
| (choice) | One of the following | |
| └ common:ID | common:ID | |
| └ common:identifier | common:identifier |
XSD Source
<xs:element name="SetUserStatus">
<xs:annotation>
<xs:documentation>Change extension status:request</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="accountData:status" type="accountData:status" minOccurs="0"/>
<xs:element name="accountData:phoneStatus" type="accountData:phoneStatus" minOccurs="0"/>
<xs:element name="common:scope" type="common:scope" minOccurs="0"/>
<xs:choice>
<xs:element name="common:ID" type="common:ID"/>
<xs:element name="common:identifier" type="common:identifier"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
</xs:element>SetUserStatusResponse
Type: common:updateObject
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Change extension status: response
Properties
| Property | Value |
|---|---|
| content | complex |
XSD Source
<xs:element name="SetUserStatusResponse" type="common:updateObject">
<xs:annotation>
<xs:documentation>Change extension status: response</xs:documentation>
</xs:annotation>
</xs:element>SetUserCpAccess
SetUserCpAccess
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Change extension control panel access:request
Properties
| Property | Value |
|---|---|
| content | complex |
Elements
| Element | Type | Description |
|---|---|---|
| accountData:cpAccess | accountData:cpAccess | |
| (choice) | One of the following | |
| └ common:ID | common:ID | |
| └ common:identifier | common:identifier |
XSD Source
<xs:element name="SetUserCpAccess">
<xs:annotation>
<xs:documentation>Change extension control panel access:request</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="accountData:cpAccess" type="accountData:cpAccess"/>
<xs:choice>
<xs:element name="common:ID" type="common:ID"/>
<xs:element name="common:identifier" type="common:identifier"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
</xs:element>SetUserCpAccessResponse
Type: common:updateObject
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Change extension control panel access: response
Properties
| Property | Value |
|---|---|
| content | complex |
XSD Source
<xs:element name="SetUserCpAccessResponse" type="common:updateObject">
<xs:annotation>
<xs:documentation>Change extension control panel access: response</xs:documentation>
</xs:annotation>
</xs:element>GetUsers
GetUsers
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Get all extensions: request
Properties
| Property | Value |
|---|---|
| content | complex |
Elements
| Element | Type | Description |
|---|---|---|
| accountData:templateID | accountData:templateID (optional) | |
| accountData:serverID | accountData:serverID (optional) | |
| common:filter | common:filter (optional) | Filter extension list name, company, email, login, |
number |
| common:scope | common:scope (optional) | | | (choice) | | One of the following | | └ accountData:parentID | accountData:parentID | | | └ accountData:parentIdentifier | accountData:parentIdentifier | |
XSD Source
<xs:element name="GetUsers">
<xs:annotation>
<xs:documentation>Get all extensions: request</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="accountData:templateID" type="accountData:templateID" minOccurs="0"/>
<xs:element name="accountData:serverID" type="accountData:serverID" minOccurs="0"/>
<xs:element name="common:filter" type="common:filter" minOccurs="0">
<xs:annotation>
<xs:documentation>Filter extension list name, company, email, login,
number</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="common:scope" type="common:scope" minOccurs="0"/>
<xs:choice>
<xs:element name="accountData:parentID" type="accountData:parentID" minOccurs="0"/>
<xs:element name="accountData:parentIdentifier" type="accountData:parentIdentifier" minOccurs="0"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
</xs:element>GetUsersResponse
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Get all extensions: response
Properties
| Property | Value |
|---|---|
| content | complex |
Elements
| Element | Type | Description |
|---|---|---|
| user | userData:UserList (0..*) | User data on succes |
| common:notice | common:notice (0..*) |
XSD Source
<xs:element name="GetUsersResponse">
<xs:annotation>
<xs:documentation>Get all extensions: response</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="user" type="userData:UserList" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>User data on succes</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="common:notice" type="common:notice" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>GetUserDetails
GetUserDetails
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Get details extension data: request
Properties
| Property | Value |
|---|---|
| content | complex |
Elements
| Element | Type | Description |
|---|---|---|
| (choice) | One of the following | |
| └ common:ID | common:ID | |
| └ common:identifier | common:identifier |
XSD Source
<xs:element name="GetUserDetails">
<xs:annotation>
<xs:documentation>Get details extension data: request</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:choice>
<xs:element name="common:ID" type="common:ID" minOccurs="0"/>
<xs:element name="common:identifier" type="common:identifier" minOccurs="0"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
</xs:element>GetUserDetailsResponse
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Get detailed extension data: response
Properties
| Property | Value |
|---|---|
| content | complex |
Extends
Base type: userData:ExtendedUserInfo
Elements
| Element | Type | Description |
|---|---|---|
| accountData:chargingPlanID | accountData:chargingPlanID (optional) | |
| accountData:chargingPlanIdentifier | accountData:chargingPlanIdentifier (optional) |
XSD Source
<xs:element name="GetUserDetailsResponse">
<xs:annotation>
<xs:documentation>Get detailed extension data: response</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:complexContent>
<xs:extension base="userData:ExtendedUserInfo">
<xs:sequence>
<xs:element name="accountData:chargingPlanID" type="accountData:chargingPlanID" minOccurs="0"/>
<xs:element name="accountData:chargingPlanIdentifier" type="accountData:chargingPlanIdentifier" minOccurs="0"/>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>DelUser
DelUser
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Delete extensions: request
Properties
| Property | Value |
|---|---|
| content | complex |
Elements
| Element | Type | Description |
|---|---|---|
| (choice) | One of the following | |
| └ common:ID | common:ID | |
| └ common:identifier | common:identifier |
XSD Source
<xs:element name="DelUser">
<xs:annotation>
<xs:documentation>Delete extensions: request</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:choice>
<xs:element name="common:ID" type="common:ID"/>
<xs:element name="common:identifier" type="common:identifier"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
</xs:element>DelUserResponse
Type: common:delObject
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Delete extensions: response
Properties
| Property | Value |
|---|---|
| content | complex |
XSD Source
<xs:element name="DelUserResponse" type="common:delObject">
<xs:annotation>
<xs:documentation>Delete extensions: response</xs:documentation>
</xs:annotation>
</xs:element>UpdateUserPL
UpdateUserPL
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Update extension permissions and limits: request
Properties
| Property | Value |
|---|---|
| content | complex |
Extends
Base type: userData:RelativeUserPLInfo
Elements
| Element | Type | Description |
|---|---|---|
| (choice) | One of the following | |
| └ common:ID | common:ID | |
| └ common:identifier | common:identifier |
XSD Source
<xs:element name="UpdateUserPL">
<xs:annotation>
<xs:documentation>Update extension permissions and limits: request</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:complexContent>
<xs:extension base="userData:RelativeUserPLInfo">
<xs:sequence>
<xs:choice>
<xs:element name="common:ID" type="common:ID" minOccurs="0"/>
<xs:element name="common:identifier" type="common:identifier" minOccurs="0"/>
</xs:choice>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>UpdateUserPLResponse
Type: common:updateObject
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Update extension permissions and limits: response
Properties
| Property | Value |
|---|---|
| content | complex |
XSD Source
<xs:element name="UpdateUserPLResponse" type="common:updateObject">
<xs:annotation>
<xs:documentation>Update extension permissions and limits: response</xs:documentation>
</xs:annotation>
</xs:element>SetUserPL
SetUserPL
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Update extension permissions and limits: request
Properties
| Property | Value |
|---|---|
| content | complex |
Extends
Base type: userData:UserPLInfo
Elements
| Element | Type | Description |
|---|---|---|
| shareVoicemail | userData:shareBetween (optional) | Share voicemail messages with other |
users |
| shareFaxes | userData:shareBetween (optional) | Share fax messages with other users | | shareRecordings | userData:shareBetween (optional) | Share recorded messages with other users | | shareCallHistory | userData:shareBetween (optional) | Share call history with other users | | (choice) | | One of the following | | └ common:ID | common:ID | | | └ common:identifier | common:identifier | |
XSD Source
<xs:element name="SetUserPL">
<xs:annotation>
<xs:documentation>Update extension permissions and limits: request</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:complexContent>
<xs:extension base="userData:UserPLInfo">
<xs:sequence>
<xs:element name="shareVoicemail" type="userData:shareBetween" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Share voicemail messages with other
users</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="shareFaxes" type="userData:shareBetween" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Share fax messages with other users</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="shareRecordings" type="userData:shareBetween" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Share recorded messages with other
users</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="shareCallHistory" type="userData:shareBetween" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Share call history with other users</xs:documentation>
</xs:annotation>
</xs:element>
<xs:choice>
<xs:element name="common:ID" type="common:ID" minOccurs="0"/>
<xs:element name="common:identifier" type="common:identifier" minOccurs="0"/>
</xs:choice>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>SetUserPLResponse
Type: common:updateObject
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Update extension permissions and limits: response
Properties
| Property | Value |
|---|---|
| content | complex |
XSD Source
<xs:element name="SetUserPLResponse" type="common:updateObject">
<xs:annotation>
<xs:documentation>Update extension permissions and limits: response</xs:documentation>
</xs:annotation>
</xs:element>GetUserPL
GetUserPL
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Get extension permissions and limits: request
Properties
| Property | Value |
|---|---|
| content | complex |
Elements
| Element | Type | Description |
|---|---|---|
| (choice) | One of the following | |
| └ common:ID | common:ID | |
| └ common:identifier | common:identifier |
XSD Source
<xs:element name="GetUserPL">
<xs:annotation>
<xs:documentation>Get extension permissions and limits: request</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:choice>
<xs:element name="common:ID" type="common:ID"/>
<xs:element name="common:identifier" type="common:identifier"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
</xs:element>GetUserPLResponse
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Get extension permissions and limits: response
Properties
| Property | Value |
|---|---|
| content | complex |
Elements
| Element | Type | Description |
|---|---|---|
| extensionPL | inline (optional) | User permissions and limits data |
| common:notice | common:notice (0..*) |
XSD Source
<xs:element name="GetUserPLResponse">
<xs:annotation>
<xs:documentation>Get extension permissions and limits: response</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="extensionPL" minOccurs="0">
<xs:annotation>
<xs:documentation>User permissions and limits data</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="common:notice" type="common:notice" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>GetUserGroups
GetUserGroups
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Get list of group IDs
Properties
| Property | Value |
|---|---|
| content | complex |
Elements
| Element | Type | Description |
|---|---|---|
| share | common:boolean | Groups that this extension can share info |
with |
| (choice) | | One of the following | | └ common:ID | common:ID | | | └ common:identifier | common:identifier | |
XSD Source
<xs:element name="GetUserGroups">
<xs:annotation>
<xs:documentation>Get list of group IDs</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="share" type="common:boolean">
<xs:annotation>
<xs:documentation>Groups that this extension can share info
with</xs:documentation>
</xs:annotation>
</xs:element>
<xs:choice>
<xs:element name="common:ID" type="common:ID"/>
<xs:element name="common:identifier" type="common:identifier"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
</xs:element>GetUserGroupsResponse
Namespace: http://4psa.com/UserMessages.xsd/5.2.5
Description: Get IDs of all groups that the extension is part of
Properties
| Property | Value |
|---|---|
| content | complex |
Elements
| Element | Type | Description |
|---|---|---|
| groups | inline (0..*) | List of groups |
| common:notice | common:notice (0..*) |
XSD Source
<xs:element name="GetUserGroupsResponse">
<xs:annotation>
<xs:documentation>Get IDs of all groups that the extension is part of</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="groups" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>List of groups</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="common:notice" type="common:notice" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>