docs: HCP organization "owner" role changes #1150
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Vercel Previews Deployed
|
Broken Link CheckerNo broken links found! 🎉 |
Younique98
approved these changes
Oct 21, 2025
xargs-P
requested changes
Oct 22, 2025
| An _organization_ is a top-level entity in HCP for organizing resources. It contains one or more | ||
| [HCP projects](/hcp/docs/hcp/admin/projects), which separate access to resources such as [HashiCorp Virtual Networks (HVN)](/hcp/docs/hcp/network) according to [user permissions](/hcp/docs/iam/users#user-permissions). | ||
|
|
||
| Users can be a member of multiple organizations if invited by the admin of other organizations. However, you can only create and own one organization for your HCP account. |
There was a problem hiding this comment.
@boruszak , while we will allow multiple owners within an organization, we still will only allow someone to create an organization if they are NOT an owner of any other orgs. Should that idea be covered in this page or a different location?
|  | ||
|
|
||
| A resource is any item that the access management system controls access to. Examples of resources are a HCP Vault Dedicated cluster, HCP Packer Bucket, HashiCorp Virtual Network (HVN) or a HCP Vault Secret App. The **Active Resources** page lists all resources created in the project. To delete a project, all resources must be deleted. If an resource exists, HCP will block users from deleting the project. This page helps you to identify what resources are still in the project. | ||
| A resource is any item that the access management system controls access to. Examples of resources are a HCP Vault Dedicated cluster, HCP Packer Bucket, HashiCorp Virtual Network (HVN) or a HCP Vault Secret App. The **Active Resources** page lists all resources created in the project. To delete a project, all resources must be deleted. If an resource exists, HCP will block users from deleting the project. This page helps you to identify what resources are still in the project. |
There was a problem hiding this comment.
How can HCP Vault Secrets is EOL. Let's remove "HCP Vault Secrets App"
| ## Add new role assignment | ||
|
|
||
| The following tables describe role permissions assigned at the organization level. | ||
| Users with the `owner` role in an organization can add and assign roles at a fine-grained level using the HCP platform. |
There was a problem hiding this comment.
This statement is true. But other roles have the manage IAM policy permission like admin and Organization IAM policies administrator . Can we list all 3 here? Or should be generalize this statement? 🤔
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
This PR updates HCP platform documentation. Previously, an organization supported a single non-transferrable owner. To better support business continuity, organizations now allow up to 3 users with the
ownerrole. These owners can be added or removed as desired, although one user must always be anownerfor the organization.Preview links