---
title: "Update instance settings"
method: PATCH
path: "/instance"
tags: ["Instance Settings"]
---

# Update instance settings

`PATCH /instance`

Updates the settings of an instance

## Request body

- object
  - `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.
  - `hibp` boolean, nullable — Whether the instance should be using the HIBP service to check passwords for breaches
  - `support_email` string, nullable
  - `clerk_js_version` string, nullable
  - `development_origin` string, nullable
  - `allowed_origins` string[] — For browser-like stacks such as browser extensions, Electron (not officially supported), or Capacitor.js (not officially supported), the instance allowed origins need to be updated with the request origin value. For Chrome extensions popup, background, or service worker pages, the origin is chrome-extension://extension_uuid. For Electron apps the default origin is http://localhost:3000. For Capacitor, the origin is capacitor://localhost.
  - `cookieless_dev` boolean, nullable — Whether the instance should operate in cookieless development mode (i.e. without third-party cookies). Deprecated: Please use `url_based_session_syncing` instead.
  - `url_based_session_syncing` boolean, nullable — Whether the instance should use URL-based session syncing in development mode (i.e. without third-party cookies).
  - `preferred_sign_in_strategy_when_password_required` 'password' | 'otp' | '', nullable — When password is required at the instance level, sets the preferred sign-in strategy surfaced to Clerk components. Has no effect when password is not required. Defaults to `password`. Set to an empty string to clear the override.

## Response `204`

Accepted

## Other responses

- `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/versions/cf036e7951d3/schema)