API Reference/Management/Tenants/Session Settings
POST
/v1/mgmt/tenant/settings

Authorization

AuthorizationRequiredBearer <token>

< Project ID >:< Management Key > as bearer

In: header

Request Body

application/jsonRequired
tenantIdstring
domainsarray<string>
selfProvisioningDomainsarray<string>
authTypestring
enabledboolean
refreshTokenExpirationinteger
Format: "int32"
refreshTokenExpirationUnitstring
sessionTokenExpirationinteger
Format: "int32"
sessionTokenExpirationUnitstring
stepupTokenExpirationinteger
Format: "int32"
stepupTokenExpirationUnitstring
enableInactivityboolean
inactivityTimeinteger
Format: "int32"
inactivityTimeUnitstring
JITDisabledboolean
curl -X POST "https://api.descope.com/v1/mgmt/tenant/settings" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "tenantId": "string",
    "domains": [
      "string"
    ],
    "selfProvisioningDomains": [
      "string"
    ],
    "authType": "string",
    "enabled": true,
    "refreshTokenExpiration": 0,
    "refreshTokenExpirationUnit": "string",
    "sessionTokenExpiration": 0,
    "sessionTokenExpirationUnit": "string",
    "stepupTokenExpiration": 0,
    "stepupTokenExpirationUnit": "string",
    "enableInactivity": true,
    "inactivityTime": 0,
    "inactivityTimeUnit": "string",
    "JITDisabled": true
  }'

OK

Was this helpful?

Get Tenant Session Settings GET

### Get session settings for a tenant This endpoint allows you to get the session settings of a given tenant. ### See Also - See [tenant session settings](/customize/tenant#session-management) for details about tenant session settings. ### Endpoint Authentication Use authorization bearer header with the following format: `Authorization: Bearer <ProjectId:ManagementKey>`

SSO Management API Overview

Use the Descope API to manage your tenants' SSO configurations with a management key.