# metalcloud-cli user suspend

Suspend a user account temporarily

## Synopsis

Suspend a user account to temporarily prevent access while preserving all data.

Suspending a user prevents them from logging in and accessing the system, but unlike
archiving, this is typically used for temporary restrictions. A reason for suspension
is required for auditing purposes.

Arguments:
  user_id                 The numeric ID of the user to suspend

Required Flags:
  --reason                The reason for suspending the user (required for audit trail)

Examples:
  metalcloud-cli user suspend 12345 --reason "Policy violation"
  metalcloud-cli user disable 12345 --reason "Account under review"

```
metalcloud-cli user suspend user_id [flags]
```

### Options

```
  -h, --help            help for suspend
      --reason string   The reason for suspending the user.
```

### Options inherited from parent commands

```
  -k, --api_key string         MetalCloud API key
  -c, --config string          Config file path
  -d, --debug                  Set to enable debug logging
  -e, --endpoint string        MetalCloud API endpoint
  -f, --format string          Output format. Supported values are 'text','csv','md','json','yaml'. (default "text")
  -i, --insecure_skip_verify   Set to allow insecure transport
  -l, --log_file string        Log file path
  -v, --verbosity string       Log level verbosity (default "INFO")
```

### SEE ALSO

* [metalcloud-cli user](/content/configuration/cli/metalcloud-cli_user.md)	 - Manage user accounts and their properties

#### Auto generated by spf13/cobra on 11-Aug-2025