Set Scope Claim Mapping | API Reference

POST

/v1/mgmt/scopeClaimMapping/set

Authorization

Descope Project ID and Management Key

AuthorizationBearer <token>

Project ID:Management Key as bearer token.

In: header

Request Body

application/json

mappings?array<ScopeClaimMappingEntry>

Ordered list of scope→claims entries replacing the project-wide mapping. Pass an empty list to clear the mapping; the dedicated DeleteScopeClaimMapping RPC is preferred when fully removing the singleton.

Replace the project-wide mapping of OIDC scopes to JWT claims. Each value may be a static string or a {{...}} template resolved at token-generation time.

curl -X POST "https://api.descope.com/v1/mgmt/scopeClaimMapping/set" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -X POST "https://api.descope.com/v1/mgmt/scopeClaimMapping/set" \  -H "Content-Type: application/json" \  -d '{}'

Was this helpful?