.TH SQ 1 1.2.0 "Sequoia PGP" "User Commands"
.SH NAME
sq key subkey delete \- Delete a certificate's secret key material
.SH SYNOPSIS
.br
\fBsq key subkey delete\fR [\fIOPTIONS\fR]  
.SH DESCRIPTION
Delete a certificate's secret key material.
.PP
Unlike `sq key delete`, which deletes all the secret key material, this command only deletes the specified secret key material.
.PP
If the secret key material is managed by multiple devices, it is deleted from all of them.
.PP
Although the secret key material is deleted, the public keys are retained.  If you don't want the keys to be used anymore you should revoke the keys using `sq key subkey revoke`.
.PP


.SH OPTIONS
.SS "Subcommand options"
.TP
\fB\-\-cert\fR=\fIFINGERPRINT|KEYID\fR
Delete secret key material from the key with the specified fingerprint or key ID
.TP
\fB\-\-cert\-email\fR=\fIEMAIL\fR
Delete secret key material from the key where a user ID includes the specified email address
.TP
\fB\-\-cert\-file\fR=\fIPATH\fR
Delete the secret key material from the key read from PATH
.TP
\fB\-\-cert\-userid\fR=\fIUSERID\fR
Delete secret key material from the key with the specified user ID
.TP
\fB\-\-key\fR=\fIFINGERPRINT|KEYID\fR
Delete the specified key's secret key material
.TP
\fB\-\-output\fR=\fIFILE\fR
Write the stripped certificate to the specified file
.IP
This option only makes sense when deleting the secret key material from a file.  When deleting secret key material managed by the key store using `\-\-cert`, you can get the stripped certificate using `sq key export`.
.SS "Global options"
See \fBsq\fR(1) for a description of the global options.
.SH EXAMPLES
.PP

.PP
Delete Alice's signing subkey.
.PP
.nf
.RS
sq key subkey delete \\
.RE
.RS
.RS
\-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \\
.RE
.RE
.RS
.RS
\-\-key=42020B87D51877E5AF8D272124F3955B0B8DECC8
.RE
.RE
.fi
.SH "SEE ALSO"
.nh
\fBsq\fR(1), \fBsq\-key\fR(1), \fBsq\-key\-subkey\fR(1).
.hy
.PP
For the full documentation see <https://book.sequoia\-pgp.org>.
.SH VERSION
1.2.0 (sequoia\-openpgp 1.22.0)