/v1/mgmt/project/settingsAuthorization
Descope Project ID and Management Key Project ID:Management Key as bearer token.
In: header
Request Body
application/json
length <= 253length <= 4096falselength <= 254falsefalselength <= 6falselength <= 254The 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.
length <= 253length <= 254length <= 254int32int32int32int32int32int32length <= 253length <= 253Concurrent-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.
int32Vendor-keyed session migration config, stored as externalAuthConfig. An empty vendor disables migration.
int32length <= 254Active template selection by id. Absent = keep the current selection; "" = reset to the built-in System template; a template id = select that stored template.
length <= 254Secret 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.
length <= 256Update 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 '{}'