---
title: "Initializes a new root generation attempt."
method: POST
path: "/sys/generate-root"
tags: ["system"]
---

# Initializes a new root generation attempt.

`POST /sys/generate-root`

Only a single root generation attempt can take place at a time. One (and only one) of otp or pgp_key are required.

## Request body

- SystemGenerateRootRequest
  - `pgp_key` string — Specifies a base64-encoded PGP public key.

## 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)