Skip to main content
Everything the dashboard and CLI do goes through the Nuon API, so you can automate it from your own product:
  • Onboard a customer. Create an install with POST /v1/installs, then send the customer the link to create the stack in their own cloud account. The customer enters any secret values there, so secrets never pass through the API. See Build a UI integration.
  • Track progress. Subscribe to webhooks for workflow and health events.
  • Collect customer approvals and input changes. See Let customers manage their install.

Getting an API token

You’ll need an access token to use the Nuon API. Create an API token from the Nuon Dashboard or the Nuon CLI. Tokens are shown only once, so store them somewhere safe.
With the API itself, create a service account with POST /v1/service-accounts, then a token for it with POST /v1/tokens. For automation and CI/CD, we recommend using OIDC Federation to avoid storing long-lived tokens.

Using the Swagger API Reference

You can call the Nuon API endpoints from the API Reference by visiting the Swagger API Reference

Using the API

You can call the Nuon API endpoints from the API Reference by adding Bearer <your-api-token> to the “Authorization” field in each endpoint card. Verify your API token with the current-user endpoint.