Skip to main content

resetPackage

Reset a package to its initialized state. This is useful for:

  • Forcing a stuck bundle off the canvas
  • Redeploying a package from scratch
  • Clearing state when destroy_state is true

The package's status will be set to INITIALIZED.

By default, the state will not be destroyed. If you want to destroy the state, set destroy_state to true. By default, the params will not be cleared. If you want to clear the params, set clear_params to true.

This mutation is an escape hatch and can lose data. Please make sure to pull any state first.

Read our manage state guide on setting up your state backend.

OpenTofu​

> tofu state pull > /somewhere/safe.tfstate

Terraform​

> terraform state pull > /somewhere/safe.tfstate

resetPackage(
  organizationId: ID!
  id: ID!
  destroyState: Boolean!
  clearParams: Boolean!
): PackagePayload

Arguments​

resetPackage.organizationId ● ID! non-null scalar​

resetPackage.id ● ID! non-null scalar​

Package ID or {project.slug}-{environment.slug}-{manifest.slug} i.e.: ecomm-staging-database

resetPackage.destroyState ● Boolean! non-null scalar​

Destroy the state of the package

resetPackage.clearParams ● Boolean! non-null scalar​

Clear the params of the package

Type​

PackagePayload object​