List Assignable Scopes

Developing

GET

/scopes/list

Last modified:2026-10-28 21:58:02

OperationId:listAssignableScopes

Returns the scopes the caller can assign to a user, built-in and custom together, so one call fills a scope picker.

Any scope can call this. The list holds only scopes the caller is allowed to assign: scopes at or below its own. A caller on a custom scope gets its own scope plus the scopes below its parent.

Hidden scopes and disabled custom scopes are left out for every caller, Super User included. To manage the full catalog, hidden scopes included, use GET /scopes?include-built-in=yes&include-hidden=yes.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200OK

application/json

The scopes the caller can assign. An empty array when it can assign none.

Bodyapplication/json

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/scopes/list' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success Example

{
    "name": "Branded Reseller",
    "built-in": "no",
    "parent-scope": "Reseller",
    "description": "Reseller without billing"
}

Modified at 2026-10-28 21:58:02

Delete custom scope

List system settings