# vhsm plugin deregister

The `plugin deregister` command deregisters an existing plugin from vHSM's plugin catalog. If the plugin does not exist, no error is returned. The plugin's type of "auth", "database", or "secret" must be included.

#### Usage <a href="#usage-1" id="usage-1"></a>

The following flags are available in addition to the standard set of flags included on all commands.

* `-version` `(string: "")` - Semantic version of the plugin to deregister. If unset, only an unversioned plugin may be deregistered.
* `<plugin-type>`: The type of plugin (e.g., `auth`, `database`, or `secret`).
* `<plugin-name>`: The name of the plugin to deregister

```bash
vhsm plugin deregister [options] <plugin-type> <plugin-name>
```

**Available Flags**

| Flag                | Description                                                                                           |
| ------------------- | ----------------------------------------------------------------------------------------------------- |
| `-version=<string>` | Semantic version of the plugin to deregister. If not set, only an unversioned plugin will be removed. |

#### Example <a href="#examples-1" id="examples-1"></a>

Deregister a plugin:

```
vhsm plugin deregister auth my-custom-plugin
```

**Output**

```
Success! Deregistered plugin (if it was registered): my-custom-plugin
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.enclaive.cloud/virtual-hsm/cli/configuration-and-management/vhsm-plugin/vhsm-plugin-deregister.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.