Environment discovery

Each Enreach customer is contained in a multi-tenanted collection of applications, called Silo.

Integrations must not hardcode endpoint addresses. Instead, the integration must discover the endpoints using https://discover.enreachvoice.com/.

Discovery is executed with a single HTTP GET request to the discovery service, supplying the username being used.

curl -H "Accept:application/json" https://discover.enreachvoice.com/api/user/?user=my.user@customer.com
[
  {
    "siloName":"Silo01",
    "username":"my.user@customer.com",
    "apiEndpoint":"https://api-theia.enreachvoice.com/",
    "authority":"https://id.enreachvoice.com/realms/main/",
    "authorityIdPHint":"idp-f93ae7a9-bc89-4856-adbb-5829429a46af"
  }
]

Versioning and compatibility

Enreach backend APIs receive updates and changes frequently. APIs strive to be backwards-compatible to reasonable extent.

Integrators must keep monitor the published release notes relevant to their application and

The release notes are found under Release notes.