Settings

Generate a new join token for multi-node cluster registration

Creates a random 32-byte hex token, stores the SHA-256 hash in settings, and returns the plaintext exactly once. If a token already exists, it is replaced.

post/settings/join-token/generate

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/settings/join-token/generate
  • Auth: HTTP bearer

Response

Join token generated

messagestring required
tokenstring required

The plaintext join token — shown only once, save it now

Changes

No recorded changes to this operation across all 53 revisions of this API.