From d99d2f610ad7cd33a5fec3fe36862485b9d0f11d Mon Sep 17 00:00:00 2001
From: vasiliyskysql <vasiliy@skysql.com>
Date: Tue, 28 Oct 2025 18:22:38 -0400
Subject: [PATCH] multi-org guide

---
 docs/guides/multi-organization-support.md     | 64 +++++++++++++++++++
 .../guides/multi-organization-support.md      | 64 +++++++++++++++++++
 2 files changed, 128 insertions(+)
 create mode 100644 docs/guides/multi-organization-support.md
 create mode 100644 templates/guides/multi-organization-support.md

diff --git a/docs/guides/multi-organization-support.md b/docs/guides/multi-organization-support.md
new file mode 100644
index 0000000..73fff3d
--- /dev/null
+++ b/docs/guides/multi-organization-support.md
@@ -0,0 +1,64 @@
+---
+page_title: "Multi-Organization Support"
+description: |-
+  Managing services across multiple SkySQL organizations
+---
+
+# Multi-Organization Support
+
+Version 3.2.0+ supports managing services across multiple organizations using the `org_id` parameter.
+
+## Usage
+
+### Single Organization (Default)
+
+Omit `org_id` to use your API key's default organization:
+
+```hcl
+resource "skysql_service" "my_service" {
+  name           = "my-database"
+  service_type   = "transactional"
+  topology       = "standalone"
+  cloud_provider = "aws"
+  region         = "us-east-1"
+  size           = "sky-2x8"
+  storage        = 100
+  ssl_enabled    = true
+}
+```
+
+### Multiple Organizations
+
+Specify `org_id` for each service to manage across different organizations:
+
+```hcl
+resource "skysql_service" "prod_db" {
+  org_id         = "org-12345-production"
+  name           = "prod-database"
+  service_type   = "transactional"
+  topology       = "standalone"
+  cloud_provider = "aws"
+  region         = "us-east-1"
+  size           = "sky-4x16"
+  storage        = 500
+  ssl_enabled    = true
+}
+
+resource "skysql_service" "dev_db" {
+  org_id         = "org-67890-development"
+  name           = "dev-database"
+  service_type   = "transactional"
+  topology       = "standalone"
+  cloud_provider = "gcp"
+  region         = "us-central1"
+  size           = "sky-2x8"
+  storage        = 100
+  ssl_enabled    = true
+}
+```
+
+## Important Notes
+
+- **Changing `org_id` destroys and recreates the service**
+- Your API key must have access to all specified organizations
+- The parameter is optional - existing configurations continue to work
diff --git a/templates/guides/multi-organization-support.md b/templates/guides/multi-organization-support.md
new file mode 100644
index 0000000..73fff3d
--- /dev/null
+++ b/templates/guides/multi-organization-support.md
@@ -0,0 +1,64 @@
+---
+page_title: "Multi-Organization Support"
+description: |-
+  Managing services across multiple SkySQL organizations
+---
+
+# Multi-Organization Support
+
+Version 3.2.0+ supports managing services across multiple organizations using the `org_id` parameter.
+
+## Usage
+
+### Single Organization (Default)
+
+Omit `org_id` to use your API key's default organization:
+
+```hcl
+resource "skysql_service" "my_service" {
+  name           = "my-database"
+  service_type   = "transactional"
+  topology       = "standalone"
+  cloud_provider = "aws"
+  region         = "us-east-1"
+  size           = "sky-2x8"
+  storage        = 100
+  ssl_enabled    = true
+}
+```
+
+### Multiple Organizations
+
+Specify `org_id` for each service to manage across different organizations:
+
+```hcl
+resource "skysql_service" "prod_db" {
+  org_id         = "org-12345-production"
+  name           = "prod-database"
+  service_type   = "transactional"
+  topology       = "standalone"
+  cloud_provider = "aws"
+  region         = "us-east-1"
+  size           = "sky-4x16"
+  storage        = 500
+  ssl_enabled    = true
+}
+
+resource "skysql_service" "dev_db" {
+  org_id         = "org-67890-development"
+  name           = "dev-database"
+  service_type   = "transactional"
+  topology       = "standalone"
+  cloud_provider = "gcp"
+  region         = "us-central1"
+  size           = "sky-2x8"
+  storage        = 100
+  ssl_enabled    = true
+}
+```
+
+## Important Notes
+
+- **Changing `org_id` destroys and recreates the service**
+- Your API key must have access to all specified organizations
+- The parameter is optional - existing configurations continue to work