---
title: pingcli mfa mfa-device-policies replace
description: Update an MFA device policy
component: pingcli
version: 1.0
page_id: pingcli:command_reference:pingcli_mfa_mfa-device-policies_replace
canonical_url: https://developer.pingidentity.com/pingcli/1.0/command_reference/pingcli_mfa_mfa-device-policies_replace.html
revdate: June 5, 2026
section_ids:
  synopsis: Synopsis
  examples: Examples
  options: Options
  options-inherited-from-parent-commands: Options inherited from parent commands
  more-information: More information
---

# pingcli mfa mfa-device-policies replace

Update an MFA device policy

## Synopsis

Update (replace) an MFA device policy in a PingOne environment with a full-body replacement

```
pingcli mfa mfa-device-policies replace [flags]
```

## Examples

```
  # Update an MFA device policy from a JSON file (--environment-id and --mfa-device-policy-id are still required)
  pingcli mfa mfa-device-policies replace --environment-id <env-id> --mfa-device-policy-id <policy-id> --from-file mfa-device-policy.json

  # Update an MFA device policy from stdin
  pingcli mfa mfa-device-policies replace --environment-id <env-id> --mfa-device-policy-id <policy-id> --from-file - < mfa-device-policy.json
```

## Options

```
  -e, --environment-id string         The PingOne environment ID
  -h, --help                          help for replace
  -f, --from-file string              Path to a JSON file containing the request body, or "-" to read from stdin.
  -m, --mfa-device-policy-id string   The MFA device policy ID
```

## Options inherited from parent commands

```
  -C, --config string           The relative or full path to a custom Ping CLI configuration file. (default $HOME/.pingcli/config.yaml)
  -D, --detailed-exitcode       Enable detailed exit code output. (default false) 0 - pingcli command succeeded with no errors or warnings. 1 - pingcli command failed with errors. 2 - pingcli command succeeded with warnings.
  -O, --output-format string    Specify the console output format. (default text) Options are: json, ndjson, ndjson-wrapped, text.
  -P, --profile string          The name of a configuration profile to use.
      --debug                   Enable debug output for error messages, including stack traces and transaction IDs. (default false)
      --log-file string         Write logs to a file at the given path. File logging is disabled when not set.
      --log-file-level string   Set the file log level. Options are: DEBUG, INFO, WARN, ERROR. (default DEBUG)
      --log-level string        Set the console log level. Options are: DEBUG, INFO, WARN, ERROR. (default WARN)
      --no-color                Disable text output in color. (default false)
      --query string            JMESPath expression to filter JSON output. Requires -O json, ndjson, or ndjson-wrapped. Example: --query 'data[?enabled].name'
```

## More information

* [pingcli mfa mfa-device-policies](pingcli_mfa_mfa-device-policies.html) - MFA Device Policies