Nuon

Nuon installs API

installs

GitHub OpenAPI

Operations 97

GET /v1/apps/{app_id}/installs get all installs for an app #
POST /v1/apps/{app_id}/installs create an app install #
GET /v1/install-workflows/{install_workflow_id} get an install workflow #
PATCH /v1/install-workflows/{install_workflow_id} update an install workflow #
POST /v1/install-workflows/{install_workflow_id}/cancel cancel an ongoing install workflow #
GET /v1/install-workflows/{install_workflow_id}/steps get all of the steps for a given install workflow #
GET /v1/install-workflows/{install_workflow_id}/steps/{install_workflow_step_id} get an install workflow step #
GET /v1/install-workflows/{install_workflow_id}/steps/{install_workflow_step_id}/approvals/{approval_id} get an install workflow step approval #
GET /v1/installs get all installs for an org #
POST /v1/installs create an app install #
GET /v1/installs/label-keys get distinct label key:value pairs across all installs for an org #
GET /v1/installs/sandbox-runs/{run_id} get an install sandbox run #
GET /v1/installs/stacks/{stack_id} get an install stack by stack ID #
DELETE /v1/installs/{install_id} delete an install #
GET /v1/installs/{install_id} get an install #
PATCH /v1/installs/{install_id} update an install #
GET /v1/installs/{install_id}/action-workflows get an installs action workflows #
GET /v1/installs/{install_id}/action-workflows/{action_workflow_id} get an install action workflow #
GET /v1/installs/{install_id}/actions get an installs action workflows #
GET /v1/installs/{install_id}/actions/{action_id} get an install action #
GET /v1/installs/{install_id}/actions/{action_id}/outputs get an install action workflow outputs #
POST /v1/installs/{install_id}/app-config-updates trigger an app config update for an install #
GET /v1/installs/{install_id}/app-config-versions get app config versions for an install #
GET /v1/installs/{install_id}/app-config-versions/{version_id}/diff get the diff for an install app config version #
GET /v1/installs/{install_id}/app-permissions-config get app permissions config for an install with provisioning status #
GET /v1/installs/{install_id}/audit_logs get install audit logs #
GET /v1/installs/{install_id}/available-roles get available IAM roles for a specific operation #
GET /v1/installs/{install_id}/components get an installs components #
POST /v1/installs/{install_id}/components/deploy-all deploy all components on an install #
GET /v1/installs/{install_id}/components/deploys get all deploys to an install #
POST /v1/installs/{install_id}/components/teardown-all teardown an install's components #
GET /v1/installs/{install_id}/components/{component_id} get an install component #
GET /v1/installs/{install_id}/components/{component_id}/deploys get an install components deploys #
POST /v1/installs/{install_id}/components/{component_id}/deploys deploy a build to an install #
GET /v1/installs/{install_id}/components/{component_id}/deploys/latest get the latest deploy for an install component #
GET /v1/installs/{install_id}/components/{component_id}/deploys/{deploy_id} get an install deploy #
POST /v1/installs/{install_id}/components/{component_id}/forget forget an install component #
GET /v1/installs/{install_id}/components/{component_id}/outputs get an install component outputs #
POST /v1/installs/{install_id}/components/{component_id}/teardown teardown an install component #
POST /v1/installs/{install_id}/components/{component_id}/toggle toggle an install component on or off #
POST /v1/installs/{install_id}/configs create an install config #
PATCH /v1/installs/{install_id}/configs/{config_id} update an install config #
GET /v1/installs/{install_id}/deploys get all deploys to an install #
POST /v1/installs/{install_id}/deploys deploy a build to an install #
GET /v1/installs/{install_id}/deploys/latest get an install's latest deploy #
GET /v1/installs/{install_id}/deploys/{deploy_id} get an install deploy #
POST /v1/installs/{install_id}/deprovision deprovision an install #
POST /v1/installs/{install_id}/deprovision-sandbox deprovision an install #
GET /v1/installs/{install_id}/drifted-objects get drifted objects for an install #
GET /v1/installs/{install_id}/events get events for an install #
GET /v1/installs/{install_id}/events/{event_id} get an install event #
POST /v1/installs/{install_id}/forget forget an install #
GET /v1/installs/{install_id}/generate-cli-install-config generate an install config to be used with CLI #
GET /v1/installs/{install_id}/generate-terraform-installer-config generate a Terraform installer config #
GET /v1/installs/{install_id}/inputs get an installs inputs #
PATCH /v1/installs/{install_id}/inputs Updates install input config for app #
POST /v1/installs/{install_id}/inputs create install inputs #
GET /v1/installs/{install_id}/inputs/current get an installs current inputs #
DELETE /v1/installs/{install_id}/labels remove labels from an install #
POST /v1/installs/{install_id}/labels add labels to an install #
POST /v1/installs/{install_id}/phone-home/{phone_home_id} phone home for an install #
GET /v1/installs/{install_id}/readme get install readme rendered with #
POST /v1/installs/{install_id}/reprovision reprovision an install #
POST /v1/installs/{install_id}/reprovision-sandbox reprovision an install sandbox #
POST /v1/installs/{install_id}/retry-workflow rerun the workflow steps starting from input step id, can be used to retry a failed step #
GET /v1/installs/{install_id}/roles get install roles #
GET /v1/installs/{install_id}/roles/latest get latest install roles #
GET /v1/installs/{install_id}/roles/usages get install role usages #
PATCH /v1/installs/{install_id}/roles/{role_id} update an install role #
POST /v1/installs/{install_id}/runner-bootstrap-token create a bootstrap token for an install's runner #
GET /v1/installs/{install_id}/runner-group Get an install's runner group #
GET /v1/installs/{install_id}/sandbox-runs get an installs sandbox runs #
GET /v1/installs/{install_id}/sandbox-runs/{run_id} get an install sandbox run #
GET /v1/installs/{install_id}/stack get an install stack by install ID #
GET /v1/installs/{install_id}/stack-runs get an install's stack runs #
GET /v1/installs/{install_id}/state Get the current state of an install. #
GET /v1/installs/{install_id}/state-history Get install state history. #
POST /v1/installs/{install_id}/sync-secrets sync secrets install #
GET /v1/installs/{install_id}/workflows get workflows #
GET /v1/workflows get all workflows for the org #
POST /v1/workflows/cancel cancel multiple workflows #
GET /v1/workflows/pending-approvals get all pending workflow step approvals for the org #
GET /v1/workflows/{workflow_id} get a workflow #
PATCH /v1/workflows/{workflow_id} update a workflow #
POST /v1/workflows/{workflow_id}/cancel cancel an ongoing workflow #
GET /v1/workflows/{workflow_id}/queue-position get queue position for a workflow #
GET /v1/workflows/{workflow_id}/step-groups get all step groups for a workflow #
GET /v1/workflows/{workflow_id}/step-groups/{step_group_id} get a workflow step group #
GET /v1/workflows/{workflow_id}/steps get all of the steps for a given workflow #
GET /v1/workflows/{workflow_id}/steps/{step_id} get a workflow step #
GET /v1/workflows/{workflow_id}/steps/{step_id}/approvals/{approval_id} get an workflow step approval #
GET /v1/workflows/{workflow_id}/steps/{step_id}/approvals/{approval_id}/contents get a workflow step approval contents #
POST /v1/workflows/{workflow_id}/steps/{step_id}/approvals/{approval_id}/response Create an approval response for a workflow step. #
GET /v1/workflows/{workflow_id}/steps/{step_id}/await long-poll for workflow step completion #
POST /v1/workflows/{workflow_id}/steps/{step_id}/cancel cancel an in-progress workflow step #
POST /v1/workflows/{workflow_id}/steps/{step_id}/retry retry a failed or awaiting-approval workflow step #
POST /v1/workflows/{workflow_id}/steps/{step_id}/skip skip a failed workflow step and continue the workflow #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/nuon/refs/heads/main/openapi/nuon-installs-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/nuon-installs-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

nuon-installs-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: support@nuon.co
    name: Nuon Support
  description: API for managing nuon apps, components, installs, and actions.
  title: Nuon accounts Installs API
  version: 0.19.1074
servers:
- url: https://api.nuon.co/
tags:
- description: installs
  name: installs
paths:
  /v1/apps/{app_id}/installs:
    get:
      description: 'Returns all installs for the provided app.

        '
      operationId: GetAppInstalls
      parameters:
      - description: app ID
        in: path
        name: app_id
        required: true
        schema:
          type: string
      - description: search query to filter installs by name or ID
        in: query
        name: q
        schema:
          type: string
      - description: label filter (key:value,key:value)
        in: query
        name: labels
        schema:
          type: string
      - description: offset of results to return
        in: query
        name: offset
        schema:
          type: integer
          default: 0
      - description: limit of results to return
        in: query
        name: limit
        schema:
          type: integer
          default: 10
      - description: page number of results to return
        in: query
        name: page
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/app.Install'
                type: array
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
      security:
      - APIKey: []
      - OrgID: []
      summary: get all installs for an app
      tags:
      - installs
    post:
      deprecated: true
      description: 'Create a new install for an app.

        '
      operationId: CreateInstall
      parameters:
      - description: app ID
        in: path
        name: app_id
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app.Install'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
      security:
      - APIKey: []
      - OrgID: []
      summary: create an app install
      tags:
      - installs
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/service.CreateInstallRequest'
        description: Input
        required: true
  /v1/install-workflows/{install_workflow_id}:
    get:
      deprecated: true
      description: 'Return a workflow.

        '
      operationId: GetInstallWorkflow
      parameters:
      - description: install workflow ID
        in: path
        name: install_workflow_id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app.Workflow'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
      security:
      - APIKey: []
      - OrgID: []
      summary: get an install workflow
      tags:
      - installs
    patch:
      deprecated: true
      description: 'Update a workflow configuration.

        '
      operationId: UpdateInstallWorkflow
      parameters:
      - description: install workflow ID
        in: path
        name: install_workflow_id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app.Workflow'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
      security:
      - APIKey: []
      - OrgID: []
      summary: update an install workflow
      tags:
      - installs
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/service.UpdateWorkflowRequest'
        description: Input
        required: true
  /v1/install-workflows/{install_workflow_id}/cancel:
    post:
      deprecated: true
      description: 'Cancel a running workflow execution.

        '
      operationId: CancelInstallWorkflow
      parameters:
      - description: install workflow ID
        in: path
        name: install_workflow_id
        required: true
        schema:
          type: string
      responses:
        '202':
          description: Accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app.EmptyResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
      security:
      - APIKey: []
      - OrgID: []
      summary: cancel an ongoing install workflow
      tags:
      - installs
  /v1/install-workflows/{install_workflow_id}/steps:
    get:
      deprecated: true
      description: 'Return all steps for a workflow.

        '
      operationId: GetInstallWorkflowSteps
      parameters:
      - description: install workflow ID
        in: path
        name: install_workflow_id
        required: true
        schema:
          type: string
      - description: offset of results to return
        in: query
        name: offset
        schema:
          type: integer
          default: 0
      - description: limit of results to return
        in: query
        name: limit
        schema:
          type: integer
          default: 10
      - description: page number of results to return
        in: query
        name: page
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/app.WorkflowStep'
                type: array
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
      security:
      - APIKey: []
      - OrgID: []
      summary: get all of the steps for a given install workflow
      tags:
      - installs
  /v1/install-workflows/{install_workflow_id}/steps/{install_workflow_step_id}:
    get:
      deprecated: true
      description: 'Return a single workflow step.

        '
      operationId: GetInstallWorkflowStep
      parameters:
      - description: workflow id
        in: path
        name: install_workflow_id
        required: true
        schema:
          type: string
      - description: step id
        in: path
        name: install_workflow_step_id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app.WorkflowStep'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
      security:
      - APIKey: []
      - OrgID: []
      summary: get an install workflow step
      tags:
      - installs
  /v1/install-workflows/{install_workflow_id}/steps/{install_workflow_step_id}/approvals/{approval_id}:
    get:
      deprecated: true
      description: 'Return a workflow step approval by id.

        '
      operationId: GetInstallWorkflowStepApproval
      parameters:
      - description: workflow id
        in: path
        name: install_workflow_id
        required: true
        schema:
          type: string
      - description: step id
        in: path
        name: install_workflow_step_id
        required: true
        schema:
          type: string
      - description: approval id
        in: path
        name: approval_id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app.WorkflowStepApproval'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
      security:
      - APIKey: []
      - OrgID: []
      summary: get an install workflow step approval
      tags:
      - installs
  /v1/installs:
    get:
      description: 'Returns all installs for the provided organization.

        '
      operationId: GetOrgInstalls
      parameters:
      - description: offset of results to return
        in: query
        name: offset
        schema:
          type: integer
          default: 0
      - description: search query to filter installs by name or ID
        in: query
        name: q
        schema:
          type: string
      - description: label filter (key:value,key:value)
        in: query
        name: labels
        schema:
          type: string
      - description: filter by runner ID
        in: query
        name: runner_id
        schema:
          type: string
      - description: limit of results to return
        in: query
        name: limit
        schema:
          type: integer
          default: 10
      - description: page number of results to return
        in: query
        name: page
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/app.Install'
                type: array
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
      security:
      - APIKey: []
      - OrgID: []
      summary: get all installs for an org
      tags:
      - installs
    post:
      description: 'Create a new install for an app.

        '
      operationId: CreateInstallV2
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app.Install'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
      security:
      - APIKey: []
      - OrgID: []
      summary: create an app install
      tags:
      - installs
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/service.CreateInstallV2Request'
        description: Input
        required: true
  /v1/installs/label-keys:
    get:
      description: Returns all distinct label key:value pairs for installs in the current org.
      operationId: GetInstallLabelKeys
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                additionalProperties:
                  items:
                    type: string
                  type: array
                type: object
      security:
      - APIKey: []
      - OrgID: []
      summary: get distinct label key:value pairs across all installs for an org
      tags:
      - installs
  /v1/installs/sandbox-runs/{run_id}:
    get:
      deprecated: true
      description: 'Return a sandbox run for an install by id.

        '
      operationId: GetInstallSandboxRun
      parameters:
      - description: run ID
        in: path
        name: run_id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app.InstallSandboxRun'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
      security:
      - APIKey: []
      - OrgID: []
      summary: get an install sandbox run
      tags:
      - installs
  /v1/installs/stacks/{stack_id}:
    get:
      description: 'Returns the deployment stack for an install.

        '
      operationId: GetInstallStack
      parameters:
      - description: stack ID
        in: path
        name: stack_id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app.InstallStack'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
      security:
      - APIKey: []
      - OrgID: []
      summary: get an install stack by stack ID
      tags:
      - installs
  /v1/installs/{install_id}:
    delete:
      description: 'Delete an install.

        '
      operationId: DeleteInstall
      parameters:
      - description: install ID
        in: path
        name: install_id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app.WorkflowResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
      security:
      - APIKey: []
      - OrgID: []
      summary: delete an install
      tags:
      - installs
    get:
      description: 'Return an install by id.

        '
      operationId: GetInstall
      parameters:
      - description: install ID
        in: path
        name: install_id
        required: true
        schema:
          type: string
      - description: whether to include drifted objects
        in: query
        name: include_drifted_objects
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app.Install'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
      security:
      - APIKey: []
      - OrgID: []
      summary: get an install
      tags:
      - installs
    patch:
      description: 'Update an install''s settings.

        '
      operationId: UpdateInstall
      parameters:
      - description: app ID
        in: path
        name: install_id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app.Install'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
      security:
      - APIKey: []
      - OrgID: []
      summary: update an install
      tags:
      - installs
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/service.UpdateInstallRequest'
        description: Input
        required: true
  /v1/installs/{install_id}/action-workflows:
    get:
      deprecated: true
      description: 'Get install action workflows.

        '
      operationId: GetInstallActionWorkflows
      parameters:
      - description: install ID
        in: path
        name: install_id
        required: true
        schema:
          type: string
      - description: offset of results to return
        in: query
        name: offset
        schema:
          type: integer
          default: 0
      - description: limit of results to return
        in: query
        name: limit
        schema:
          type: integer
          default: 10
      - description: page number of results to return
        in: query
        name: page
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/app.InstallActionWorkflow'
                type: array
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
      security:
      - APIKey: []
      - OrgID: []
      summary: get an installs action workflows
      tags:
      - installs
  /v1/installs/{install_id}/action-workflows/{action_workflow_id}:
    get:
      deprecated: true
      description: 'Get an install action workflow.

        '
      operationId: GetInstallActionWorkflow
      parameters:
      - description: install ID
        in: path
        name: install_id
        required: true
        schema:
          type: string
      - description: workflow ID
        in: path
        name: action_workflow_id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app.InstallActionWorkflow'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
      security:
      - APIKey: []
      - OrgID: []
      summary: get an install action workflow
      tags:
      - installs
  /v1/installs/{install_id}/actions:
    get:
      description: 'Get install action workflows.

        '
      operationId: GetInstallActions
      parameters:
      - description: install ID
        in: path
        name: install_id
        required: true
        schema:
          type: string
      - description: offset of results to return
        in: query
        name: offset
        schema:
          type: integer
          default: 0
      - description: limit of results to return
        in: query
        name: limit
        schema:
          type: integer
          default: 10
      - description: page number of results to return
        in: query
        name: page
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: OK
          content:
            application/json:

# --- truncated at 32 KB (354 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/nuon/refs/heads/main/openapi/nuon-installs-api-openapi.yml