---
title: "Register a new plugin, or updates an existing one with the supplied name."
method: POST
path: "/sys/plugins/catalog/{name}"
tags: ["system"]
---

# Register a new plugin, or updates an existing one with the supplied name.

`POST /sys/plugins/catalog/{name}`

## Request body

- SystemPluginsCatalogRequest
  - `args` string[] — The args passed to plugin command.
  - `command` string — The command used to start the plugin. The executable defined in this command must exist in vault's plugin directory.
  - `env` string[] — The environment variables passed to plugin command. Each entry is of the form "key=value".
  - `sha256` string — The SHA256 sum of the executable used in the command field. This should be HEX encoded.
  - `type` string — The type of the plugin, may be auth, secret, or database
  - `version` string — The semantic version of the plugin to use.

## Response `200`

OK

---

[API](https://skmtc.dev/lensesio/apis/hashicorp-vault-api.md) · [All operations](https://skmtc.dev/lensesio/apis/hashicorp-vault-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lensesio/hashicorp-vault-api/revisions/bd8194de0697/schema)