---
title: "Update instance settings"
method: PATCH
path: "/beta_features/instance_settings"
tags: ["Beta Features"]
---

# Update instance settings

`PATCH /beta_features/instance_settings`

Updates the settings of an instance

## Request body

- object
  - `restricted_to_allowlist` boolean, nullable — Whether sign up is restricted to email addresses, phone numbers and usernames that are on the allowlist.
  - `from_email_address` string, nullable — The local part of the email address from which authentication-related emails (e.g. OTP code, magic links) will be sent. Only alphanumeric values are allowed. Note that this value should contain only the local part of the address (e.g. `foo` for `foo@example.com`).
  - `progressive_sign_up` boolean, nullable — Enable the Progressive Sign Up algorithm. This feature is deprecated, please contact support if you need assistance.
  - `test_mode` boolean, nullable — Toggles test mode for this instance, allowing the use of test email addresses and phone numbers. Defaults to true for development instances.

## Response `200`

InstanceSettings Server API

- object
  - `object` 'instance_settings' — String representing the object's type. Objects of the same type share the same value.
  - `id` string
  - `restricted_to_allowlist` boolean
  - `from_email_address` string
  - `progressive_sign_up` boolean
  - `enhanced_email_deliverability` boolean — Deprecated. When enabled, production authentication emails for this instance are sent through Clerk's legacy managed email delivery path. This setting is being retired; use the instance's configured email sending domain instead.

## Other responses

- `402` — Payment required
- `422` — Invalid request parameters

---

[API](https://skmtc.net/clerk/apis/clerk-backend-api.md) · [All operations](https://skmtc.net/clerk/apis/clerk-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clerk/clerk-backend-api/revisions/cf036e7951d3/schema)