From 0c89cc74132d74f7aa4afd0e859da2109d4bef59 Mon Sep 17 00:00:00 2001 From: Sarah Sanders Date: Tue, 22 Apr 2025 12:16:40 -0400 Subject: [PATCH] security: remove outdated limitation and add suggestion for OATs (#22461) ## Description - PATs are transferred to org owners when converting a user account to an org now - Adds suggestion to use OATs - Preview: https://deploy-preview-22461--docsdocker.netlify.app/admin/organization/convert-account/ ## Related issues or tickets - [ENGDOCS-2567](https://docker.atlassian.net/browse/ENGDOCS-2567) ## Reviews - [ ] Editorial review [ENGDOCS-2567]: https://docker.atlassian.net/browse/ENGDOCS-2567?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ --------- Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- content/manuals/admin/organization/convert-account.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/content/manuals/admin/organization/convert-account.md b/content/manuals/admin/organization/convert-account.md index 00db9570d8..66791d0396 100644 --- a/content/manuals/admin/organization/convert-account.md +++ b/content/manuals/admin/organization/convert-account.md @@ -48,7 +48,13 @@ Consider the following effects of converting your account: - The user account that you add as the first owner will have full administrative access to configure and manage the organization. -- Converting a user account to an organization will delete all of the user's personal access tokens. See [Create an access token](/manuals/security/for-developers/access-tokens.md#create-an-access-token) for steps on creating personal access tokens after converting the user account. +- To transfer a user's personal access tokens (PATs) to your converted organization, +you must designate the user as an organization owner. This will ensure any PATs associated with the user's account are transferred to the organization owner. + +> [!TIP] +> +> To avoid potentially disrupting service of personal access tokens when converting an account or changing ownership, it is recommended to use [organization access tokens](/manuals/security/for-admins/access-tokens.md). Organization access tokens are +associated with an organization, not a single user account. ## Convert an account into an organization