From 174e6b9607b2594b190bd139376cf8ca4a6a701c Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Fri, 18 Sep 2026 09:18:43 -0400 Subject: [PATCH 01/15] Create overview.mdx --- organizations/overview.mdx | 63 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 organizations/overview.mdx diff --git a/organizations/overview.mdx b/organizations/overview.mdx new file mode 100644 index 00000000..25ef4294 --- /dev/null +++ b/organizations/overview.mdx @@ -0,0 +1,63 @@ +--- +title: Organizations +sidebarTitle: Overview +description: "Manage enterprise GPU workloads with centralized resource ownership, post-paid billing, and role-based access control." +--- + +Organizations are Runpod's enterprise account model, designed for teams that need centralized resource ownership, billing, and access control. Unlike Teams, an organization is a first-class entity that owns all resources independently of any individual member. + + +Organizations are currently in beta. Runpod provisions organization accounts and enables them for your account. If you're an existing Team account customer, see [Migrate from Teams](/organizations/migrate-from-teams). + + +## How Organizations differ from Teams + +| | Teams | Organizations | +|---|---|---| +| Resource ownership | Resources owned by the team owner's user account | Resources owned by the organization, surviving if any member leaves | +| Billing | Prepaid credit balance | Post-paid invoice only. No credit balance or payment method management in the console. | +| Membership | A user can own one team and belong to others | A user belongs to at most one organization | +| Social unit | Team (has an owner) | Group (leaderless, additive) | +| Mutual exclusivity | Compatible with personal accounts | Mutually exclusive with Teams, permanently | + + +Organizations and Teams are mutually exclusive. Accepting an organization invitation permanently removes you from any Team you belong to. Your personal resources fold into the organization and cannot be returned to personal ownership. + + +## Key concepts + +**Ownership.** The organization owns all resources, not the member who created them. If a member is removed or suspended, their Pods, endpoints, and volumes continue running under the organization. + +**Membership.** A user can belong to at most one organization. Joining an organization is permanent and mutually exclusive with Team membership. There is no path back to a Team account once you join. + +**Roles.** Every member is assigned one of four built-in roles: admin, billing, dev, or basic. Roles control what a member can create, manage, or view. See [Roles](/organizations/roles) for the full permissions matrix. + +**Groups.** Groups are the social unit within an organization. They are leaderless and additive: a member can belong to zero or many groups simultaneously. Only org admins can manage group membership. See [Groups](/organizations/groups). + +**Billing.** Organizations are billed on a post-paid invoice model. Usage accrues throughout the month and is invoiced by Runpod's finance team. There is no credit balance, no autopay, and no payment method management in the console. See [Billing](/organizations/billing). + +## Get started + + + + Understand the four built-in roles and what each can do across compute, billing, and org management. + + + Create and manage groups to organize members and control resource visibility. + + + Learn how post-paid invoicing works, who can access Billing Explorer, and how to use cost centers. + + + Set up SSO, configure approved domains, invite members, and restrict access by IP range. + + + Manage named SSH keys per member and understand how they inject into your organization's Pods. + + + Create and apply tags to Pods, endpoints, and volumes for cost attribution and filtering. + + + Understand what happens during migration, what to prepare, and what is irreversible. + + From 10d0b9eebe71abe45f978b2590c46f47191ed5a3 Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Fri, 18 Sep 2026 09:24:52 -0400 Subject: [PATCH 02/15] Update overview.mdx --- organizations/overview.mdx | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/organizations/overview.mdx b/organizations/overview.mdx index 25ef4294..2568b3a4 100644 --- a/organizations/overview.mdx +++ b/organizations/overview.mdx @@ -1,10 +1,10 @@ --- -title: Organizations -sidebarTitle: Overview +title: "Organizations" +sidebarTitle: "Overview" description: "Manage enterprise GPU workloads with centralized resource ownership, post-paid billing, and role-based access control." --- -Organizations are Runpod's enterprise account model, designed for teams that need centralized resource ownership, billing, and access control. Unlike Teams, an organization is a first-class entity that owns all resources independently of any individual member. +Organizations are Runpod's enterprise account model, designed for teams that need centralized resource ownership, billing, and access control. Unlike Teams, an organization is a first-class entity that owns all resources independent of any individual member, including compute, storage, secrets, and templates. Organizations are currently in beta. Runpod provisions organization accounts and enables them for your account. If you're an existing Team account customer, see [Migrate from Teams](/organizations/migrate-from-teams). @@ -14,11 +14,11 @@ Organizations are currently in beta. Runpod provisions organization accounts and | | Teams | Organizations | |---|---|---| -| Resource ownership | Resources owned by the team owner's user account | Resources owned by the organization, surviving if any member leaves | -| Billing | Prepaid credit balance | Post-paid invoice only. No credit balance or payment method management in the console. | -| Membership | A user can own one team and belong to others | A user belongs to at most one organization | -| Social unit | Team (has an owner) | Group (leaderless, additive) | -| Mutual exclusivity | Compatible with personal accounts | Mutually exclusive with Teams, permanently | +| **Resource ownership** | Resources owned by the team owner's user account | Resources owned by the organization, surviving if any member leaves | +| **Billing** | Prepaid credit balance | Post-paid invoice only. No credit balance or payment method management in the console. | +| **Membership** | A user can own one team and belong to others | A user belongs to at most one organization | +| **Social unit** | Team (has an owner) | Group (leaderless, additive) | +| **Mutual exclusivity** | Compatible with personal accounts | Mutually exclusive with Teams, permanently | Organizations and Teams are mutually exclusive. Accepting an organization invitation permanently removes you from any Team you belong to. Your personal resources fold into the organization and cannot be returned to personal ownership. @@ -30,11 +30,11 @@ Organizations and Teams are mutually exclusive. Accepting an organization invita **Membership.** A user can belong to at most one organization. Joining an organization is permanent and mutually exclusive with Team membership. There is no path back to a Team account once you join. -**Roles.** Every member is assigned one of four built-in roles: admin, billing, dev, or basic. Roles control what a member can create, manage, or view. See [Roles](/organizations/roles) for the full permissions matrix. +**Roles.** Every member is assigned one of four built-in roles: admin, billing, dev, or basic. There is no owner role; admin is the highest level. Roles control what a member can create, manage, or view across compute, billing, and org settings. See [Roles](/organizations/roles) for the full permissions matrix. **Groups.** Groups are the social unit within an organization. They are leaderless and additive: a member can belong to zero or many groups simultaneously. Only org admins can manage group membership. See [Groups](/organizations/groups). -**Billing.** Organizations are billed on a post-paid invoice model. Usage accrues throughout the month and is invoiced by Runpod's finance team. There is no credit balance, no autopay, and no payment method management in the console. See [Billing](/organizations/billing). +**Billing.** Organizations are billed on a post-paid invoice model. Usage accrues throughout the month and is invoiced by Runpod's finance team. There is no credit balance, credit top-up, credit code redemption, or autopay. All members can view their own usage in Billing Explorer; org admins can view any member's usage. See [Billing](/organizations/billing). ## Get started From 741901443bbe5ec702f323769f7d67baf939a637 Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Fri, 18 Sep 2026 10:08:16 -0400 Subject: [PATCH 03/15] Create org-roles.mdx --- organizations/org-roles.mdx | 48 +++++++++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 organizations/org-roles.mdx diff --git a/organizations/org-roles.mdx b/organizations/org-roles.mdx new file mode 100644 index 00000000..7dbdbc75 --- /dev/null +++ b/organizations/org-roles.mdx @@ -0,0 +1,48 @@ +--- +title: "Roles" +sidebarTitle: "Roles" +description: "Control what organization members can do with four built-in roles. Learn which actions each role can perform." +--- + +Every member of an organization is assigned one of four built-in roles: admin, billing, dev, or basic. There is no owner role; admin is the highest level. Only org admins can assign or change member roles. + +## Role overview + +| Action | Admin | Dev | Billing | Basic | +|---|---|---|---|---| +| Manage members, groups, and org settings | ✓ | — | — | — | +| View member roster | ✓ | ✓ | ✓ | ✓ | +| Create and manage compute resources | ✓ | ✓ | — | — | +| View and use existing compute resources | ✓ | ✓ | — | ✓ | +| Manage billing and cost centers | ✓ | — | ✓ | — | +| View all members' usage | ✓ | — | ✓ | — | +| View own usage | ✓ | ✓ | ✓ | ✓ | + +## Role descriptions + +**Admin.** Full organization management. Admins can invite and remove members, manage groups and roles, update org settings, and create, update, or delete any org resource. Assign this role to team leads who need full control. + +**Dev.** Full compute access with no billing or member management. Devs can deploy Pods, create Serverless endpoints, manage network volumes, Instant Clusters, and templates. They cannot view billing, manage cost centers, or manage members or groups. Assign this role to engineers and researchers who build and run workloads. + +**Billing.** Financial management only, with no access to compute resources. The billing role can view all members' usage in Billing Explorer and manage cost centers. They cannot view, create, or interact with any compute resource. Assign this role to finance staff who need billing visibility without operational access. + +**Basic.** Read and use access to existing resources. Basic members can view and connect to existing Pods, endpoints, volumes, and clusters, but cannot create new resources. Assign this role to members who need access to existing workloads without deployment permissions. + +## Assign a role + +Only admins can assign or change member roles. Role changes take effect immediately. + + + + Go to **User management** in the console and select the **Users** tab. + + + Locate the member whose role you want to change. + + + Click the role dropdown next to their name and select the new role. + + + Confirm the change. The new role takes effect immediately. + + From 43f7ee7f5c5982e9d7c433fd725758ea1294980b Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Fri, 18 Sep 2026 10:20:40 -0400 Subject: [PATCH 04/15] Create orgs-groups.mdx --- organizations/orgs-groups.mdx | 66 +++++++++++++++++++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 organizations/orgs-groups.mdx diff --git a/organizations/orgs-groups.mdx b/organizations/orgs-groups.mdx new file mode 100644 index 00000000..6ff82b22 --- /dev/null +++ b/organizations/orgs-groups.mdx @@ -0,0 +1,66 @@ +--- +title: "Groups" +sidebarTitle: "Groups" +description: "Organize organization members into groups to control resource visibility and structure teams within your organization." +--- + +Groups let you organize members by team, project, or function. Only org admins can create groups and manage membership. + +## How groups work + +Groups are leaderless and additive. There is no group owner or group-level admin. A member can belong to zero or many groups at the same time, and joining one group has no effect on membership in any other. + +## Create a group + + + + Go to **User management** in the console and select the **Groups** tab. + + + Click **Create a new group**, enter a name, and confirm. + + + +## Add a member to a group + + + + Go to **User management → Groups** and find the group. + + + Click **Add a user to this group**, enter the member's name or email, and select them. + + + +## Remove a member from a group + + + + Go to **User management → Groups** and find the group. + + + Click **Remove from group** next to the member's name. This removes them from the group only — they remain in the organization. + + + +## Rename a group + + + + Go to **User management → Groups** and find the group. + + + Click **Rename**, enter the new name, and confirm. + + + +## Delete a group + + + + Go to **User management → Groups** and find the group. + + + Click **Delete this group** and confirm. Members in the group are not affected and remain in the organization. + + From 156b6c44a78bea6ae301e15930727457b0770ff6 Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Fri, 18 Sep 2026 10:26:50 -0400 Subject: [PATCH 05/15] Create orgs-billing.mdx --- organizations/orgs-billing.mdx | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 organizations/orgs-billing.mdx diff --git a/organizations/orgs-billing.mdx b/organizations/orgs-billing.mdx new file mode 100644 index 00000000..a9254c7a --- /dev/null +++ b/organizations/orgs-billing.mdx @@ -0,0 +1,23 @@ +--- +title: "Billing" +sidebarTitle: "Billing" +description: "Understand how organization billing works, including post-paid invoicing, Billing Explorer access, and cost centers for spend attribution." +--- + +Organizations are billed on a post-paid invoice model. Usage from all members accrues throughout the month and is invoiced by Runpod's finance team. There is no credit balance, credit top-up, or payment method to manage in the console. + +## Billing Explorer + +Billing Explorer shows resource usage broken down by member, resource type, and time period. All members with access can open it from **Billing** in the console left nav. + +Admin and billing roles see usage for all org members. Dev members see their own usage only. + +## Cost centers + +Cost centers let you attribute spend across projects, teams, or departments by tagging resources with a cost center label. Admin and billing roles can create, update, and delete cost centers. + +To create a cost center, go to **Cost centers** in the console and click **Create cost center**. + +## Invoices and payment + +Invoices are issued by Runpod's finance team at the end of each billing period. For invoice questions, payment terms, or billing disputes, contact your Runpod account team directly. From d3203bc00f0a64c8a5ffa67b1c34a15644bc6fa7 Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Fri, 18 Sep 2026 10:39:04 -0400 Subject: [PATCH 06/15] Create orgs-access.mdx --- organizations/orgs-access.mdx | 55 +++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 organizations/orgs-access.mdx diff --git a/organizations/orgs-access.mdx b/organizations/orgs-access.mdx new file mode 100644 index 00000000..f091d134 --- /dev/null +++ b/organizations/orgs-access.mdx @@ -0,0 +1,55 @@ +--- +title: "Access" +sidebarTitle: "Access" +description: "Control who joins your organization with email invitations. Learn how to invite, accept, and remove members." +--- + +Runpod provisions organization accounts. Once your org is provisioned, org admins invite members by sending invitations to their exact email addresses. Only admins can invite and remove members. + +## Invite a member + + + + Go to **User management** in the console and select the **Users** tab. + + + Click **Invite Member**, enter the member's exact email address, select their role, and send. + + + +The invited user receives an email with a link to accept. They must have a verified Runpod account to accept the invitation. + +Invitations expire after 14 days. Each organization can have up to 150 pending invitations at a time. Admins can cancel a pending invitation from the **Users** tab. + +## Accept an invitation + +To accept an org invitation, the invitee must not be a member of any Runpod team. If they belong to a team, they must leave or delete it before the invitation can be accepted. + + + + Click the link in the invitation email. + + + Sign in to Runpod with the account associated with the invited email address. + + + Accept the invitation in the console. + + + + +Accepting an org invitation does not move personal resources into the organization. Existing Pods, endpoints, network volumes, and other personal resources remain on the member's personal account unless migrated by Runpod staff separately. + + +## Remove a member + + + + Go to **User management** in the console and select the **Users** tab. + + + Find the member and click **Remove**. The member is removed from the organization immediately. + + + +When a member is removed, their org S3 credentials are revoked immediately. Their Pods, endpoints, and other org resources remain in the organization. From 9bf39326867730f214ec120d9ac765ba127f6f19 Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Fri, 18 Sep 2026 11:37:35 -0400 Subject: [PATCH 07/15] Create orgs-resource-tag --- organizations/orgs-resource-tag | 36 +++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 organizations/orgs-resource-tag diff --git a/organizations/orgs-resource-tag b/organizations/orgs-resource-tag new file mode 100644 index 00000000..102e9ef8 --- /dev/null +++ b/organizations/orgs-resource-tag @@ -0,0 +1,36 @@ +--- +title: "Resource tagging" +sidebarTitle: "Resource tagging" +description: "Attach key-value tags to organization resources to track spend, filter usage, and attribute costs across teams, projects, and cost centers." +--- + +Resource tagging is available to organization accounts only. Tags are key-value pairs you attach to org resources to track spend, filter usage, and attribute costs across teams or projects. Tagging is supported on Pods, Serverless endpoints, network volumes, and Instant Clusters. + +## Tag format + +- Tag keys must be non-empty. Tag values may be left blank. +- Each resource supports a maximum of 25 tags. +- The combination of key and value must be unique on a resource. +- Keys using the `runpod:` prefix are reserved for system use and cannot be created. +- All org members can view all tags regardless of who created them. +- Admin and dev roles can create, edit, and delete tags. Basic members can apply existing tags to resources. Billing members can only view tags. + +## System tags + +Runpod automatically manages one reserved tag: `runpod:cost-center`. This tag is applied by the system when you assign a resource to a cost center. You cannot create or modify tags that use the `runpod:` namespace prefix. + +## Add a tag + +You can add tags when deploying a new resource or after deployment by editing an existing resource. + +**During deployment:** In the deploy form, expand the **Tags** section. Click **Add Tag**, enter a key and value, and continue with deployment. + +**On an existing resource:** Navigate to the resource in the console and open its details. Click **Tags**, then **Add Tag**. Enter a key and value and click **Save**. + +## Remove a tag + +Navigate to the resource in the console and open its details. Click **Tags** and click the delete icon next to the tag you want to remove. + +## Filter by tag + +Use tags to filter resources in the console or query usage by tag in Billing Explorer. This helps attribute spend to specific teams, projects, or cost centers. From f2ba2af7897279171f683b8c881bbe4ed9216077 Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Fri, 18 Sep 2026 11:44:41 -0400 Subject: [PATCH 08/15] Rename overview.mdx to orgs-overview.mdx --- organizations/{overview.mdx => orgs-overview.mdx} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename organizations/{overview.mdx => orgs-overview.mdx} (100%) diff --git a/organizations/overview.mdx b/organizations/orgs-overview.mdx similarity index 100% rename from organizations/overview.mdx rename to organizations/orgs-overview.mdx From 49b846ae3c1260023693ba5a819390e2e6679984 Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Fri, 18 Sep 2026 12:02:32 -0400 Subject: [PATCH 09/15] Rename orgs-resource-tag to orgs-resource-tags --- organizations/{orgs-resource-tag => orgs-resource-tags} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename organizations/{orgs-resource-tag => orgs-resource-tags} (100%) diff --git a/organizations/orgs-resource-tag b/organizations/orgs-resource-tags similarity index 100% rename from organizations/orgs-resource-tag rename to organizations/orgs-resource-tags From c531361efabe22d1e5d2d841c1f63f495b7546d0 Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Fri, 18 Sep 2026 12:07:25 -0400 Subject: [PATCH 10/15] Rename orgs-resource-tags to orgs-resource-tagging --- organizations/{orgs-resource-tags => orgs-resource-tagging} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename organizations/{orgs-resource-tags => orgs-resource-tagging} (100%) diff --git a/organizations/orgs-resource-tags b/organizations/orgs-resource-tagging similarity index 100% rename from organizations/orgs-resource-tags rename to organizations/orgs-resource-tagging From 78e712a0905d3ca49764abba736441fab056d5f9 Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Fri, 18 Sep 2026 12:07:38 -0400 Subject: [PATCH 11/15] Rename orgs-resource-tagging to orgs-resource-tagging.mdx --- .../{orgs-resource-tagging => orgs-resource-tagging.mdx} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename organizations/{orgs-resource-tagging => orgs-resource-tagging.mdx} (100%) diff --git a/organizations/orgs-resource-tagging b/organizations/orgs-resource-tagging.mdx similarity index 100% rename from organizations/orgs-resource-tagging rename to organizations/orgs-resource-tagging.mdx From 537bdd6573b641834176365d57925a83bfcd6d4b Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Fri, 18 Sep 2026 12:08:20 -0400 Subject: [PATCH 12/15] Update docs.json --- docs.json | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs.json b/docs.json index 8607adfd..d445318c 100644 --- a/docs.json +++ b/docs.json @@ -287,6 +287,17 @@ "accounts-billing/add-tax-id" ] }, + { + "group": "Organizations", + "pages": [ + "organizations/orgs-overview", + "organizations/orgs-access", + "organizations/org-roles", + "organizations/orgs-groups", + "organizations/orgs-resource-tagging", + "organizations/orgs-billing" + ] + }, { "group": "Integrations", "pages": [ From 039b4fc61af6b8b4d23eb9ad0c819404b79540a8 Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Fri, 18 Sep 2026 12:38:11 -0400 Subject: [PATCH 13/15] Update docs.json --- docs.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs.json b/docs.json index d445318c..f01e4fd7 100644 --- a/docs.json +++ b/docs.json @@ -288,7 +288,7 @@ ] }, { - "group": "Organizations", + "group": "Organizations (Beta)", "pages": [ "organizations/orgs-overview", "organizations/orgs-access", From 861babcd5c6215962c551f8507f08f9a1819b580 Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Fri, 18 Sep 2026 12:39:36 -0400 Subject: [PATCH 14/15] Update orgs-overview.mdx --- organizations/orgs-overview.mdx | 26 +------------------------- 1 file changed, 1 insertion(+), 25 deletions(-) diff --git a/organizations/orgs-overview.mdx b/organizations/orgs-overview.mdx index 2568b3a4..6186b3a2 100644 --- a/organizations/orgs-overview.mdx +++ b/organizations/orgs-overview.mdx @@ -36,28 +36,4 @@ Organizations and Teams are mutually exclusive. Accepting an organization invita **Billing.** Organizations are billed on a post-paid invoice model. Usage accrues throughout the month and is invoiced by Runpod's finance team. There is no credit balance, credit top-up, credit code redemption, or autopay. All members can view their own usage in Billing Explorer; org admins can view any member's usage. See [Billing](/organizations/billing). -## Get started - - - - Understand the four built-in roles and what each can do across compute, billing, and org management. - - - Create and manage groups to organize members and control resource visibility. - - - Learn how post-paid invoicing works, who can access Billing Explorer, and how to use cost centers. - - - Set up SSO, configure approved domains, invite members, and restrict access by IP range. - - - Manage named SSH keys per member and understand how they inject into your organization's Pods. - - - Create and apply tags to Pods, endpoints, and volumes for cost attribution and filtering. - - - Understand what happens during migration, what to prepare, and what is irreversible. - - + From 9482609aa6ee3270e438fea2683edfcf7dbee20d Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Fri, 18 Sep 2026 16:22:43 -0400 Subject: [PATCH 15/15] Update orgs-groups.mdx --- organizations/orgs-groups.mdx | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/organizations/orgs-groups.mdx b/organizations/orgs-groups.mdx index 6ff82b22..107a6e0a 100644 --- a/organizations/orgs-groups.mdx +++ b/organizations/orgs-groups.mdx @@ -10,6 +10,12 @@ Groups let you organize members by team, project, or function. Only org admins c Groups are leaderless and additive. There is no group owner or group-level admin. A member can belong to zero or many groups at the same time, and joining one group has no effect on membership in any other. +## Resource visibility + +Groups control which resources members can see in the console. By default, a member can only see resources they created themselves. When a resource is assigned to a group, all members of that group can see it, regardless of who created it. + +Admins can see all resources across the organization, including resources that belong to no group and resources in groups they are not a member of. + ## Create a group