This document is for an older version of Kazoo (version 4.3) that is no longer supported. You should upgrade and read the current documentation.

Connectivity

About Connectivity

Schema

Trunkstore configuration document - this is old stuff; do not recommend building off this if possible

KeyDescriptionTypeDefaultRequiredSupport Level
account.caller_id.cid_namestring(0..35)false
account.caller_id.cid_numberstring(0..35)false
account.caller_idobject()false
account.emergency_caller_id.cid_namestring(0..35)false
account.emergency_caller_id.cid_numberstring(0..35)false
account.emergency_caller_idobject()false
account.trunksThe number of two-way trunks this account has purchasedinteger()false
accountInformation that applies to the account as a wholeobject()false
nameHuman-friendly name of the trunkstore accountstring()false
servers.[].DIDs./^\+?\d*$/.caller_id.cid_namestring(1..35)false
servers.[].DIDs./^\+?\d*$/.caller_id.cid_numberstring(1..35)false
servers.[].DIDs./^\+?\d*$/.caller_idobject()false
servers.[].DIDs./^\+?\d*$/.failover.e164An E.164 formatted DID to dial for failoverstring()false
servers.[].DIDs./^\+?\d*$/.failover.sipA SIP URI (sip:user@host) to call for failoverstring()false
servers.[].DIDs./^\+?\d*$/.failoverRoute inbound call to another destination if this server fails to handle the callobject()false
servers.[].DIDs./^\+?\d*$/.force_outboundboolean()falsefalse
servers.[].DIDs./^\+?\d*$/.options.[]string()false
servers.[].DIDs./^\+?\d*$/.optionsarray(string())false
servers.[].DIDs./^\+?\d*$/object()false
servers.[].DIDsobject()false
servers.[].auth.auth_methodWhat type of auth mechanism to use`string(‘password''Password''IP''ip’)`
servers.[].auth.auth_passwordPassword of the user@auth_realmstring(1..)false
servers.[].auth.auth_userUsername for authenticationstring(1..)false
servers.[].auth.ipIP (sip) address for this devicestring()false
servers.[].auth.portPort to send SIP traffic for the remote deviceinteger()false
servers.[].authobject()true
servers.[].nameHuman-friendly name of the serverstring(1..)false
servers.[].options.caller_id.cid_namestring(1..35)false
servers.[].options.caller_id.cid_numberstring(1..35)false
servers.[].options.caller_idobject()false
servers.[].options.delayThe time, in seconds, to wait before attempting to call the serverinteger()0false
servers.[].options.dynamic_flags.[]string()false
servers.[].options.dynamic_flagsList of function names (or ‘zone’) that are called on the Call record to populate the ‘flags’ array sent to the resource(s) for matchingarray(string())false
servers.[].options.emergency_caller_id.cid_namestring(0..35)false
servers.[].options.emergency_caller_id.cid_numberstring(0..35)false
servers.[].options.emergency_caller_idobject()false
servers.[].options.enabledIs the server ready for sending and receiving callsboolean()truefalse
servers.[].options.failover.e164An E.164 formatted DID to dial for failoverstring()false
servers.[].options.failover.sipA SIP URI (sip:user@host) to call for failoverstring()false
servers.[].options.failoverRoute inbound call to another destination if this server fails to handle the callobject()false
servers.[].options.flags.[]string()false
servers.[].options.flagsList of flags to use when matching resources to route the callarray(string())false
servers.[].options.force_outboundIf true, will send the call over configured carriers instead of to the server (as opposed to the ‘enabled’ flag, which will reject the calls)boolean()falsefalse
servers.[].options.hunt_account_idWhen using local resources, use this account instead of the account making the call (useful for resellers)string()false
servers.[].options.hunt_non_reconcilableWhether to allow routing to continue on a non-reconcilable TO numberboolean()falsefalse
servers.[].options.ignore_early_mediaboolean()false
servers.[].options.inbound_formatDetermines how the INVITE is sent to the server`string(‘e164''npan''1npan''username'
servers.[].options.ipIP (sip) address for this devicestring()false
servers.[].options.media_handlingDetermine whether the switch should be in the media path or not`string(‘process''bypass’)`bypassfalse
servers.[].options.portPort to send SIP traffic for the remote deviceinteger()false
servers.[].options.progress_timeoutThe time, in seconds, to wait for the server to progress in the call, before trying an optionally defined failover route or terminating the callinteger()false
servers.[].options.sip_headersList of arbitrary SIP headers to add to the INVITEarray(object())false
servers.[].options.timeoutThe time, in seconds, to wait for an answer from the serverinteger()false
servers.[].optionsobject()false
serversWhat servers will be allowed to make/receive calls via this accountarray(object())[]false

Fetch

GET /v2/accounts/{ACCOUNT_ID}/connectivity

curl -v -X GET \
    -H "X-Auth-Token: {AUTH_TOKEN}" \
    http://{SERVER}:8000/v2/accounts/{ACCOUNT_ID}/connectivity

Create

PUT /v2/accounts/{ACCOUNT_ID}/connectivity

curl -v -X PUT \
    -H "X-Auth-Token: {AUTH_TOKEN}" \
    http://{SERVER}:8000/v2/accounts/{ACCOUNT_ID}/connectivity

Fetch

GET /v2/accounts/{ACCOUNT_ID}/connectivity/{CONNECTIVITY_ID}

curl -v -X GET \
    -H "X-Auth-Token: {AUTH_TOKEN}" \
    http://{SERVER}:8000/v2/accounts/{ACCOUNT_ID}/connectivity/{CONNECTIVITY_ID}

Change

POST /v2/accounts/{ACCOUNT_ID}/connectivity/{CONNECTIVITY_ID}

curl -v -X POST \
    -H "X-Auth-Token: {AUTH_TOKEN}" \
    http://{SERVER}:8000/v2/accounts/{ACCOUNT_ID}/connectivity/{CONNECTIVITY_ID}

Patch

PATCH /v2/accounts/{ACCOUNT_ID}/connectivity/{CONNECTIVITY_ID}

curl -v -X PATCH \
    -H "X-Auth-Token: {AUTH_TOKEN}" \
    http://{SERVER}:8000/v2/accounts/{ACCOUNT_ID}/connectivity/{CONNECTIVITY_ID}

Remove

DELETE /v2/accounts/{ACCOUNT_ID}/connectivity/{CONNECTIVITY_ID}

curl -v -X DELETE \
    -H "X-Auth-Token: {AUTH_TOKEN}" \
    http://{SERVER}:8000/v2/accounts/{ACCOUNT_ID}/connectivity/{CONNECTIVITY_ID}

On this page