Skip to content
CLIUnofficial

privy clients domains configure

Configure an owned HTTP-only cookie domain; DNS setup remains explicit.

Usage

Section titled “Usage”
Terminal window
privy clients domains configure [options] <client-id>

Arguments

Section titled “Arguments”
Argument Description
client-id —

Options

Section titled “Options”
Option Description
--dry-run Validate and print the API request without network access or credentials.
--yes Confirm this mutation or export.
--allow-session-impact Acknowledge that disabling/deleting cookie domains can log out app users.
--body <json> JSON body, or - to read stdin.
--file <path> JSON body file, or - to read stdin.
--cookie-domain <string> Owned DNS hostname, not an origin URL. Normalized to lowercase/ASCII. Changing an existing hostname requires explicit deletion first.
--enabled <boolean> Initial client cookie setting. Configure is setup-only: an existing client domain cannot be toggled here. Removal requires explicit delete and session-impact confirmation.
--diff Read live state and show changes WITHOUT writing (requires login).
--allow-production Explicitly allow this production mutation; also requires --yes.

Global options such as --app, --account and --profile also apply. See the command reference overview.

Examples

Section titled “Examples”
Terminal window
privy clients domains configure <client-id> --cookie-domain example.com --enabled true --dry-run

Behavior

Section titled “Behavior”
  • Changes data: yes. Preview with --dry-run, then run with --yes and any required confirmations.
  • Scope: app
  • Before it runs: Check environment, current domain and optional same-app web client. No implicit domain replacement or allowed-origin expansion.
  • Production apps: Requires --allow-production and --yes.
  • Verification: Fresh configuration/status read-back. DNS verification is reported separately; an owned DNS domain is required.
  • Retries: None.
Section titled “Related guides”

Inspect the full contract locally with privy schema clients domains configure.

Privy CLI is an unofficial, community project by Samarth Saxena. Not affiliated with or endorsed by Privy. The Privy name and wordmark belong to Privy. It uses undocumented dashboard APIs that can change.