Skip to content

The assistant sees exactly what your API key’s role can see. The role is set when you create the key. Only roles whose permissions fit within your own are available.

  • Pick a role that can read the data you want to ask about: calls, campaigns, routing, reports.
  • Read-only use never needs a role that can change data. The server cannot change anything in any case.

With a smaller role, some questions are answered with:

  • fewer records,
  • an empty list, or
  • “Your API key’s role cannot use this. Ask a Teleflows admin for a key with more access.”

Some fields can be missing or masked for your role, for example caller numbers or money fields. The assistant says so instead of treating them as zero.