CloudIVR API [beta]

CloudIVR API is undergoing changes. Docs will be updated soon!

Authorization

Authorization is based on ”Apikey” HTTP header which returns the value from the main screen.

General info:

  • response - JSON
  • success - http 200
  • error - http != 0, JSON object containing msg field with an error message

Local Agent

GET /api/v1/local-agents

get information about local Agents

GET /api/v1/local-agents/[ID]

get information about a local Agent

PUT /api/v1/local-agents/[ID]/snooze

snooze an Agent, returns the Agent object (like GET)

PUT /api/v1/local-agents/[ID]/wake

wake an Agent, returns the Agent object (like GET)

Database (Global Variables)

GET /database/[key]

return a key from a local database

POST /database/[key]

set a value parameter for a key in a local database

Alias Number

GET /channels/[id]/alias-numbers

return a list of aliases for a telephone number

POST /channels/[id]/alias-numbers/tag

select the least recently used alias and assign it a tag

required parameters:

  • tag (string)
  • minutes (integer) - tag lifetime

DELETE /channels/[id]/alias-numbers/:id/tag

delete a tag (before it expires)

CALLERID BLOCKING

Everyone can call a newly tagged number. The first caller is assigned to the number (alias). Since then, only this caller (number) will be able to call this alias, till the tag lifetime expiration.

Need Help?