---
title: "Enables a new auth method."
method: POST
path: "/sys/auth/{path}"
tags: ["system"]
---

# Enables a new auth method.

`POST /sys/auth/{path}`

After enabling, the auth method can be accessed and configured via the auth path specified as part of the URL. This auth path will be nested under the auth prefix.

For example, enable the "foo" auth method will make it accessible at /auth/foo.

## Request body

- SystemAuthRequest
  - `config` object — Configuration for this mount, such as plugin_name.
  - `description` string — User-friendly description for this credential backend.
  - `external_entropy_access` boolean — Whether to give the mount access to Vault's external entropy.
  - `local` boolean — Mark the mount as a local mount, which is not replicated and is unaffected by replication.
  - `options` object — The options to pass into the backend. Should be a json object with string keys and values.
  - `plugin_name` string — Name of the auth plugin to use based from the name in the plugin catalog.
  - `plugin_version` string — The semantic version of the plugin to use.
  - `seal_wrap` boolean — Whether to turn on seal wrapping for the mount.
  - `type` string — The type of the backend. Example: "userpass"

## Response `200`

OK

---

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