FR EN

Tenants

Estimated reading: 10 minutes
GET

tenants.list

This action allows you to list all the existing tenants:

/documentation/premiers-pas/tenants/

http://VOTREIPBX.FR/index.php?apikey=VOTRECLEAPI&action=pbxware.tenant.list
PARAMS
apikey

API key generated on your PBXware

action

pbxware.tenants.list
Action with methods to retrieve the requested value(s)

name

Tenant name

tenantcode

Unique tenant code

package

Package ID

ext_length

Extension digit length

country_id

Tenant country ID

country_codeTenant country code

Example request:

curl --location 'votre.ipbx.fr/index.php?apikey=votre.clé.api&action=pbxware.tenant.list'

Example response:

{ "2": { "name": "t1.dot.com", "tenantcode": "344", "package_id": "1", "package": "Package 1", "ext_length": 3, "country_id": "869", "country_code": "1", }, "7": { "name": "t2.dot.com", "tenantcode": "454", "package_id": "2", "package": "Package 2", "ext_length": 3, "country_id": "869", "country_code": "1", } }
GET

tenants.configuration

This action allows you to configure a trunk for a particular tenant.

/documentation/premiers-pas/tenants/

http://VOTREIPBX.FR/index.php?apikey=VOTRECLEAPI&action=pbxware.tenant.configuration&id=10
PARAMS
apikeyAPI key generated on your PBXware
actionpbxware.tenants.configuration
Action with methods to retrieve the requested value(s)
tenant_nameTenant name (Required)
tenant_codeUnique 3-digit tenant code (Required)
packageTenant package ID (Required)
ext_lengthExtension length (Required)
countryCountry ID (Required)
area_codeArea code (Required)
nationalNational code (Required)
internationalInternational code (Required)
glocom_dns_srv_lookupUse DNS SRV lookup for gloCOM
glocomproxySIP Proxy for gloCOM
apusernameHTTP Username
appasswordHTTP password
defaultserverDefault server
announcetrunksAnnounce trunks
absolutetimeoutAbsolute delay
cdrvoicemailVoicemail in CDRs
faxformatFAX page format
faxfiletypeFAX file type
enabletcallsEnable tenant-to-tenant calls
disabletcidDisable caller ID rewriting for tenant-to-tenant calls
tenantcidDefault caller ID
tenant_faxcidDefault FAX caller ID
usedefaultcidUse the default caller ID for tenant-to-tenant calls
usedidcidUse DIDs as caller ID for tenant-to-tenant calls
finde164Find E.164 numbers in DIDs
recordlimitNumber of objects per page (Default: 10)
showdiroscShow the directory in OSC
recordglobalRecord calls by default
recordsilentDefault silent recording
mp3_auto_convConvert recordings to mp3 during generation
recordbeepPlay a periodic beep
recordformatRecording format
audiolangAudio language
cpark_timeoutEnhanced call parking delay (in seconds)
cpark_dialEnhanced call parking announcement
cpark_gotoEnhanced call park timeout extension
limitsoundPlay a sound
limitemailInternational code (Required)
notifyemailInternational code (Required)
leavenationalLeave National Code
currencyCurrency symbol / ISO code
currencyposCurrency writing convention
dialed_num_minimum_lengthMinimum length of the dialed number
pstn_modePSTN dialing mode
callgroupsCall groups / Pickup groups (separated by commas)
incominglimitLocal channels
outgoinglimitRemote channels
conchConference channels
quechQueue channels
ergchEnhanced ring group channels
aachAuto attendant channels
zapchDAHDI channels
localcodecsLocal codecs
remotecodecsRemote codecs
networkcodecsNetwork codecs
hdcheckChecking login attempts
hdlockextLock the extension after X failed attempts
hdlockdeviceLock the phone after X locked extensions
hdautologoutAutomatic logout
hdlogoutinactiveLogout after X hours of inactivity
ringtonelocalRingtone for local calls
hidecalleridHide caller ID in OSC
allowescalleridAllow « ES CallerID » for call forwarding
enablecnamlookupEnable caller ID CNAM lookup
setcidforgrouphuntSet the caller ID for hunt group calls
cidmatchdidAllow only the trunk caller ID within the DID range
dropanonymousReject anonymous calls
didsaveupdatecidOn DID record, update ES/CID/Trunks
forceunknownDo not allow users to send any Caller ID
hideextnodirHide extensions with no department (gloCOM)
custompresencetimegloCOM offline presence delay (minutes)
usedynfeaturesUse dynamic features
nobillingfwd (deprecated and will soon be replaced by cf_call_rating_disable)Disable billing for call forwarding (deprecated and will soon be replaced by cf_call_rating_disable)
cf_call_rating_disableDisable call rating for call forwarding

Example request:

curl --location 'votre.ipbx.fr/index.php?apikey=votre.clé.api&action=pbxware.tenant.configuration&id=10'
GET

tenants.add

This action allows you to add a new tenant:

/documentation/premiers-pas/tenants/

http://VOTREIPBX.FR/index.php?apikey=VOTRECLEAPI&action=pbxware.tenant.add&tenant_name=TestAPI&tenant_code=555&package=&ext_length=&country=&national=&international=
PARAMS
apikeyAPI key generated on your PBXware
actionpbxware.tenants.add
Action with methods to retrieve the requested value(s)
tenant_nameTenant name (Required)Must be a valid FQDN (Fully Qualified Domain Name)
tenant_codeUnique 3-digit tenant code (Required)
packageTenant package ID (Required)Can be obtained with the package object
ext_lengthExtension length (Required)Can be in the range 2-16 ONLY
countryCountry ID (Required)Can be obtained with the route object
area_codeRegional code
nationalNational code (Required)
internationalInternational code (Required)
glocom_dns_srv_lookupUse gloCOM DNS SRV lookup
glocomproxygloCOM SIP Proxy
apusernameHTTP Username
appasswordHTTP password
defaultserverDefault server
announcetrunksAnnounce trunks
absolutetimeoutAbsolute delay
cdrvoicemailVoicemail in CDRs2: As Voicemail, 1: As missed calls, 0: As answered calls
faxformatFAX page formatletter, legal, A4, auto
faxfiletypeFAX file type1: PDF and TIFF, 2: PDF only, 3: TIFF only
default_locationDefault extension location (Local=1, Remote=2)
enabletcallsEnable inter-tenant calls
disabletcidDisable caller ID rewriting for inter-tenant calls
tenantcidDefault caller ID
tenant_faxcidDefault caller ID for fax
usedefaultcidUse the default caller ID for calls between tenants
usedidcidUse DIDs as caller ID for calls between tenants
finde164Find E.164 numbers in DIDs
recordlimitNumber of objects per page (Default: 10)
showdiroscShow the directory in the OSC
recordglobalRecord calls by default
recordsilentDefault silent recording
mp3_auto_convConvert recordings to mp3 upon generation
recordbeepPlay periodic beep
recordformatRecording formatgsm: GSM, wav: WAV, wav49: WAV49, g729: native G729, ogg: OGG
audiolangAudio language
cpark_timeoutEnhanced call parking delay (in seconds)
cpark_dialEnhanced call parking announcement extension
cpark_gotoEnhanced call parking timeout extension
limitsoundPlay a sound
limitemailInternational code (Required)
notifyemailInternational code (Required)
leavenationalLeave National Code
currencyCurrency symbol/ISO code
currencyposCurrency writing conventionleft: Symbol before the amount, right: Symbol after the amount
dialed_num_minimum_lengthMinimum length of the dialed number
pstn_modePSTN dialing mode
callgroupsCall groups/Pickup groups (separated by commas)
localcodecsLocal codecs
remotecodecsRemote codecs
networkcodecsNetwork codecs
hdcheckChecking login attempts
hdlockextLock the extension after X failed attempts
hdlockdeviceLock the phone after X locked extensions
hdautologoutAutomatic logout
hdlogoutinactiveLogout after X hours of inactivity
ringtonelocalRingtone for local calls
hidecalleridHide caller ID in OSC
allowescalleridAllow ES caller ID for call forwarding
enablecnamlookupEnable CNAM lookup for the caller ID
setcidforgrouphuntSet the caller ID for hunt group calls
cidmatchdidAllow only the trunk caller ID within the DID range
dropanonymousReject anonymous calls
didsaveupdatecidOn DID save, update ES/CID/Trunks
forceunknownDo not allow users to send any Caller ID
hideextnodirHide extensions with no department (gloCOM)
custompresencetimegloCOM offline presence delay (in minutes)
usedynfeaturesUse dynamic features
nobillingfwdDisable billing for call forwarding(deprecated and will soon be replaced by cf_call_rating_disable)
cf_call_rating_disableDisable call rating
jbimplJitter bufferinherit, disabled, fixed, adaptive
jbmaxsizeMaximum size (ms)
jbresyncthresholdResynchronization threshold
jbtargetextraExtra target
allowextipauthAllow IP address authentication for extensionsYes=1, No=0
voiceskippinSkip the PIN request for voicemailYes=1, No=0
email_fromFrom the email
vm_email_fromFrom the voicemail email
local_channelsLocal channels
remote_channelsRemote channels
conferencesConferences
queuesQueues
auto_attendantsAuto attendants
dahdiDAHDI
dids_notify_emailNotification email
dids_notify_orderSort by
es_ambulanceAmbulance
es_fireFire
es_policeFont
es_notification_emailNotification email
ldap_enabledEnable LDAPYes=1, No=0
ldap_local_extsInclude system extensions(Yes=1, No=0, Not set=”)
ldap_hotdeskingEnable LDAP for remote-work devices(Yes=1, No=0, Not set=”)
ldap_passwordLDAP password

Example request:

curl --location 'votre.ipbx.fr/index.php?apikey=votre.clé.api&action=pbxware.tenant.add&tenant_name=Client1&tenant_code=999&package=2&ext_length=3&country=france&national=33'

Example response:

{ "success": "Tenant ID: 10", "id": 10 }
GET

tenants.edit

This action allows you to modify a tenant:

/documentation/premiers-pas/tenants/

http://VOTREIPBX.FR/index.php?apikey=VOTRECLEAPI&action=pbxware.tenant.list
PARAMS
apikeyAPI key generated on your PBXware
actionpbxware.tenants.edit
Action with methods to retrieve the requested value(s)
status

Status (Inactive=0, Active=1, Suspended=2)
The other arguments are identical to those in the Adding Tenants section, except for ext_length, which cannot be modified. They are all optional, except for

server

ID of the server, which must be set to 1

id

Tenant ID

Example request:

curl --location 'votre.ipbx.fr/index.php?apikey=votre.clé.api&action=pbxware.tenant.list'

Example response:

{ "success": "Tenant ID: 10", "id": 10 }
GET

tenants.delete

This action allows you to delete a tenant:

/documentation/premiers-pas/tenants/

http://VOTREIPBX.FR/index.php?apikey=VOTRECLEAPI&action=pbxware.tenant.delete&server=1&id=8
PARAMS
apikeyAPI key generated on your PBXware
actionpbxware.tenants.edit
Action with methods to retrieve the requested value(s)
status

Status (Inactive=0, Active=1, Suspended=2)
The other arguments are identical to those in the Adding Tenants section, except for ext_length, which cannot be modified. They are all optional, except for

server

ID of the server, which must be set to 1

id

Tenant ID

Example request:

curl --location 'votre.ipbx.fr/index.php?apikey=votre.clé.api&action=pbxware.tenant.delete&server=1&id=8'

Example response:

{ "success": "Tenant ID: 10", "id": 10 }
GET

tenants.trunks.list

This action allows you to list the tenants along with the associated trunks:

/documentation/premiers-pas/tenants/

http://VOTREIPBX.FR/index.php?apikey=VOTRECLEAPI&action=pbxware.tenant.trunks.list&tenant=10
PARAMS
apikeyAPI key generated on your PBXware
actionpbxware.tenants.list
Action with methods to retrieve the requested value(s)
tenant

Tenant ID 
Example: 10

Example request:

curl --location 'votre.ipbx.fr/index.php?apikey=votre.clé.api&action=pbxware.tenant.trunks.list&tenant=10'

Example response:

{ "success": "Tenant ID: 10", "id": 10 }
GET

tenants.trunks.list

This action allows you to list the tenants along with the associated trunks:

/documentation/premiers-pas/tenants/

http://VOTREIPBX.FR/index.php?apikey=VOTRECLEAPI&action=pbxware.tenant.trunks.list&tenant=10
PARAMS
apikeyAPI key generated on your PBXware
actionpbxware.tenants.list
Action with methods to retrieve the requested value(s)
tenant

Tenant ID 
Example: 10

Example request:

curl --location 'votre.ipbx.fr/index.php?apikey=votre.clé.api&action=pbxware.tenant.trunks.list&tenant=10'
GET

tenant.trunks.set

This action allows you to list the tenants along with the associated trunks:

/documentation/premiers-pas/tenants/

http://VOTREIPBX.FR/index.php?apikey=VOTRECLEAPI&action=pbxware.tenant.trunks.set&tenant=10&trunks=75&primary_trunk=&primary_emerg_trunk=
PARAMS
apikeyAPI key generated on your PBXware
actionpbxware.tenants.list
Action with methods to retrieve the requested value(s)
tenantTenant ID 
Example: 10
trunksList of trunk IDs (comma-separated).
(Regex: /^[0-9,]+$/)
primary_trunk
Primary trunk
(Regex : /^\d{1,10}$/)
secondary_trunk
Secondary trunk
(Regex : /^\d{1,10}$/)
tertiary_trunk
Tertiary trunk
(Regex : /^\d{1,10}$/)
primary_emerg_trunk

Primary emergency trunk
(Regex: /^\d{1,10}$/)

secondary_emerg_trunk

Secondary emergency trunk
(Regex: /^\d{1,10}$/)

tertiary_emerg_trunk

Tertiary emergency trunk
(Regex: /^\d{1,10}$/)

Example request:

curl --location 'votre.ipbx.fr/index.php?apikey=votre.clé.api&action=pbxware.tenant.trunks.set&tenant=10&trunks=75&primary_trunk=&primary_emerg_trunk=...'
Share

Tenants

Or copy the link below

CONTENT