Skip to main content
An Install runs a Package on a Cluster. This reference covers creating and removing Installs, reading their state and rendered configuration, and following their asynchronous Operations. You need an authenticated session, access to a Workspace, and an existing Package and Cluster in that Workspace. Select the Workspace with the Akua-Context request header.

Follow an operation

Creating or deleting an Install returns an Operation. Read that Operation to follow its progress, or use its wait endpoint to wait for a bounded time. A wait timeout leaves the Operation running. You can request cancellation of a Create operation; cleanup completes before cancellation is reported as finished.

Remove an install

Read the Install’s current etag and send it in the If-Match header when deleting. If another command changed the Install, read it again before retrying. Deletion returns an Operation so you can follow cleanup to completion. Deletion cannot be cancelled; required cleanup continues until it finishes. The API Reference describes the available requests, headers, and response schemas.