Skip to content

Draft feature docs: deleting an AWS cloud account#390

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/ad55ccfe
Open

Draft feature docs: deleting an AWS cloud account#390
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/ad55ccfe

Conversation

@mintlify

@mintlify mintlify Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

Summary

Documents the new AWS cloud account deletion flow shipped in porter-dev/code#6564, including the dashboard experience, the teardown stages, and the corresponding API endpoints.

Changes

  • New page cloud-accounts/deleting-a-cloud-account.mdx covering prerequisites, the dashboard delete flow, deletion states, the DELETE /clouds/{cloud_account_id} and /dependents API endpoints, and troubleshooting.
  • Updated the AWS "Revoking Access" section in connecting-a-cloud-account.mdx to point at the new flow.
  • Updated deleting-a-cluster.mdx (AWS tab) to reference the new cloud account deletion flow instead of only suggesting manual CloudFormation cleanup.
  • Added the new page to the Cloud Accounts navigation in mint.json.

Context

porter-dev/code#6564 (support aws deletion) adds end-to-end deletion for AWS cloud accounts: a DELETE /clouds/{cloud_account_id} endpoint, a /dependents endpoint that lists blocking clusters / object storage / environment groups, a deletion_pending account state with per-step teardown progress (IAM roles, IAM policies, access revoked), and a dashboard delete section with confirmation dialog and live status. Porter tears down all roles and policies it created in the customer account, then waits on the customer to remove porter-access-manager (via the PorterRole CloudFormation stack) before finalizing.

cc @d-g-town for review.

@mintlify mintlify Bot requested a review from d-g-town June 25, 2026 23:03
@mintlify

mintlify Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
porter 🟢 Ready View Preview Jun 25, 2026, 11:06 PM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants