Auth - Settings

Update auth settings

Updates enabled providers, feature flags, and session duration for an environment.

put/api/auth/settings

Request

Base URL: https://api.ascendkit.dev (the document declares no server; this is the origin it was published from)
URL: https://api.ascendkit.dev/api/auth/settings
Auth: API key in header X-AscendKit-Public-Key and HTTP bearer

Request body

providersstring[] nullable

Enabled sign-in providers for the environment.

sessionDurationstring nullable

Session lifetime expressed as a duration string.

allowedDomainsstring[] nullable

Email domains allowed to sign up. Empty list clears restrictions.

blockPersonalDomainsboolean nullable

Block signups from common personal email providers.

tosUrlstring nullable

Absolute HTTPS URL to the customer's Terms of Service. Pass empty string to clear. Validated as absolute https URL with length cap 2048.

Example request

{
  "providers": [
    "credentials",
    "google"
  ],
  "sessionDuration": "7d",
  "allowedDomains": [
    "company.com",
    "partner.org"
  ],
  "tosUrl": "https://your-app.com/legal/terms"
}

Response

Successful Response

dataunknown

errorstring nullable

metaobject nullable

Changes

No recorded changes to this operation across all 1 revision of this API.