All terms

Scope

A scope is a named permission on an API key that limits which endpoints it may call: reading balance, buying numbers, managing rentals.

In detail

Scopes are fixed for the life of a key — to widen access you create a second key rather than editing the first. An endpoint that needs a scope the key lacks answers 403 and names the missing scope in the message. The practical value is blast radius: a key scoped to reads cannot spend your balance if it leaks into a log file.

Also known as

  • permission
  • api scope

Related terms