request_id (JSON body field, at most 255 characters). Use it from your own automation when a lost response must not start a second workflow. Nuon stores that id with the workflow. Send the same id and the same body again and the API returns the original workflow_id (and run id where applicable).
Calls that omit request_id start a new workflow every time. The CLI and the dashboard omit it.
If you’re building customer-facing setup in your own product, start with Build a UI integration. It shows where request_id fits in that flow.
The id is unique for one org, one install, and one workflow type, for as long as that workflow exists. Generate a new id for each workflow you intend to start once, and store it before the POST so a timeout retry uses the same id.
Example
Deploy all components on an install:workflow_id. A later call with deploy-acme-prod-1 and the same body returns that same id.
The Go SDK helpers, such as DeployInstallComponents, do not send request_id. Set the field on the JSON body when you call the API yourself.
Different body
The same id with a different body returns409:
plan_only, inputs, the action config, the adhoc command, or the runbook steps is a different body. Use a new request_id for that workflow.
Install moved to a new app config
Nuon records the install’s app config when it accepts the request. If the install is on a newer app config when you retry, the API returns409 and names both config ids. That failure is permanent for this id. Starting a workflow against the new config takes a new request_id.
An adhoc run does not use this check. The script or command in the body is the work being run.
If the install’s app config changes while a deploy, reprovision, action, or runbook workflow from that request is still generating steps, that workflow fails. An adhoc run keeps going.
A call that fails
A call that fails before Nuon stores the workflow does not keep the id. Send the samerequest_id and body again.
A 201 means the workflow is stored. Retrying returns it, including when the workflow is already running or finished.