Beta Features

Update production instance domain

Changed on

Change the domain of a production instance.

Changing the domain requires updating the DNS records accordingly, deploying new SSL certificates, updating your Social Connection's redirect URLs and setting the new keys in your code.

WARNING: Changing your domain will invalidate all current user sessions (i.e. users will be logged out). Also, while your application is being deployed, a small downtime is expected to occur.

Returns 403 domain_managed_by_integration for applications in a Vercel-managed workspace; change the domain from the Vercel integration instead.

put/beta_features/domain

Request

  • Base URL: https://api.clerk.com/v1
  • URL: https://api.clerk.com/v1/beta_features/domain
  • Auth: HTTP bearer

Request body

home_urlstring

The new home URL of the production instance e.g. https://www.example.com

is_secondaryboolean

Whether the domain is a secondary app.

Response

Accepted

Changes