Pools

Issue a single-use host enrollment token

The secret expires after 24 hours. Observe enrollment is the default. Explicit execute reenrollment binds one existing host and rotates its credential when used. It can be prepared before enabling Route. Requests are not idempotent and must not be automatically replayed.

post/v1/pools/{id}/enrollment-tokens

Request

  • Base URL
    / (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    HTTP bearer

Path parameters

idstring required

Identifier returned by Nodus.

Request body

mode'observe' | 'execute'
host_idstring

Existing host in this pool required for execute reenrollment. Rejected for observe mode.

Response

Issue a single-use host enrollment token

idstring required
tokenstring required

Secret single-use enrollment token returned only when issued. Keep it out of logs and source control.

mode'observe' | 'execute' required
expires_atstring date-time required

Changes

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