API ReferenceManagementProject Management
POST
/v1/mgmt/project/settings

Authorization

Descope Project ID and Management Key
AuthorizationBearer <token>

Project ID:Management Key as bearer token.

In: header

Request Body

application/json

appUrl?string
customDomain?string
Lengthlength <= 253
trustedDomains?string
Lengthlength <= 4096
defaultNoSSOApps?boolean
tenantUserIsolation?boolean
testUserRegex?string
Defaultfalse
Lengthlength <= 254
testUserAllowFixedAuth?boolean
Defaultfalse
testUserFixedAuthToken?string
Defaultfalse
Lengthlength <= 6
testUserFixedAuthVerifierRegex?string
Defaultfalse
Lengthlength <= 254
allowAuthHostingIframeEmbedding?boolean
disableAuthHosting?boolean
appsCustomDomain?string

The custom domain federated and inbound app URLs are built on: the hostname of customDomain or of one of the project's other custom domains. Empty means customDomain.

Lengthlength <= 253
userTemplateId?string
Lengthlength <= 254
keyTemplateId?string
Lengthlength <= 254
refreshTokenExpiration?integer
Formatint32
refreshTokenExpirationUnit?string
rotateJwt?boolean
sessionTokenExpiration?integer
Formatint32
sessionTokenExpirationUnit?string
stepupTokenExpiration?integer
Formatint32
stepupTokenExpirationUnit?string
trustedDeviceTokenExpiration?integer
Formatint32
trustedDeviceTokenExpirationUnit?string
keySessionTokenExpiration?integer
Formatint32
keySessionTokenExpirationUnit?string
enableInactivity?boolean
inactivityTime?integer
Formatint32
inactivityTimeUnit?string
refreshTokenResponseMethod?string
refreshTokenCookiePolicy?string
refreshTokenCookieDomain?string
Lengthlength <= 253
sessionTokenResponseMethod?string
sessionTokenCookiePolicy?string
sessionTokenCookieDomain?string
Lengthlength <= 253
maxConcurrentSessions?integer

Concurrent-session limit (NIST SP 800-53 AC-10). 0 means no limit. The upper bound is configured per deployment and enforced by projectservice, so it is deliberately not repeated here - a hardcoded ceiling would reject values the console accepts. Enforcement applies to sessions created after it is set; pre-existing sessions are untracked.

Formatint32
sessionMigration?object

Vendor-keyed session migration config, stored as externalAuthConfig. An empty vendor disables migration.

projectSelfProvisioning?boolean
inviteUrl?string
inviteExpireUser?boolean
inviteExpirationTime?integer
Formatint32
inviteExpirationTimeUnit?string
inviteMagicLink?boolean
inviteSendEmail?boolean
inviteSendSms?boolean
inviteEmailConnectorId?string
Lengthlength <= 254
inviteEmailTemplateId?string

Active template selection by id. Absent = keep the current selection; "" = reset to the built-in System template; a template id = select that stored template.

Lengthlength <= 254
trustedProxySecret?string

Secret a trusted reverse proxy sends in the x-descope-proxy-secret header, so its forwarded host headers are honored. At least 64 visible ASCII characters, no spaces (e.g. the output of openssl rand -base64 48). Write-only: reads return PLACEHOLDER_VALUE when set, "" clears it.

Lengthlength <= 256

Update the project's settings, using a valid management key.

curl -X POST "https://api.descope.com/v1/mgmt/project/settings" \  -H "Content-Type: application/json" \  -d '{}'
Was this helpful?