Powered by Redocly

Create Root Token

Invoke the create-root operation

This action requires root privileges. It can be used to generate a new root token for the current tenant, or for a newly created subtenant. It can also be used to create a new root token for an existing subtenant with the wipe option set to true. This will, however, result in all secrets being erased from the subtenant.

SecurityaccessToken
Request
query Parameters
site
string

Send the request to the specfifed site

Request Body schema:
name
string
wipe
boolean
Default: false

The system prevents the creation of a root token for a tenant, except for newly created tenants. This is to prevent unrestricted access to tenant secrets. However, in an emergency a root token can be created for a tenant by specifying the wipe=true option. This will result in all secrets being removed from the tenant before issuing the new root token. Use with care.

Responses
200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

503

Service Unavailable (strongbox sealed)

post/v1/state/strongbox/token/create-root
Request samples 
name: acme
wipe: true
Response samples 
accessor: b7c1abeb-7f45-4f5c-9aba-97ceb117f777
token: fe665fd1-ad8c-4ec6-a594-b4cc15123b36
creation-time: 2022-01-13T08:59:52.110681Z
➔ Next to Create Token