Update Custom Scope

Testing

PUT

/scopes/{name}

Last modified:2026-08-27 23:58:55

OperationId:updateCustomScope

Updates a custom scope. Only supplied fields change; modifications replaces the whole map. Edits take effect on live tokens within seconds — enforcement re-reads the definition, tokens are not reissued. Setting enabled: no refuses the scope's tokens exactly as a delete would, reversibly.

Writes are published on the internal event bus and applied cluster-wide; a 202 means "published", and the row is visible on each server once its event lands.

Requires Super User (reads also allow Super User Read Only) — enforced in the controller; scope_priv cannot express it.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢202Accepted

Published.

This response does not have a body.

🟠400Bad Request

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/scopes/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "modifications": {
        "nsconfig": "none",
        "route": "ro",
        "phonenumber": "none"
    }
}'

Modified at 2026-08-27 23:58:55

Read Custom Scope

Delete Custom Scope