From e937abc4bd3cfe34bb827562a9d3b0a24e2f2112 Mon Sep 17 00:00:00 2001
From: Hassan Ahmed <hassan.ahmed@phrase.com>
Date: Tue, 23 Jun 2026 14:15:54 +0200
Subject: [PATCH] docs(API): gate multi-project automation on
 advanced_job_automation plan feature (SCM-1408)

Update project_ids field description in automation create and update
operations to reflect that submitting more than one project ID requires
the advanced_job_automation plan feature. Accounts without this feature
receive a 422 response with error field project_ids.
---
 doc/compiled.json             | 4 ++--
 paths/automations/create.yaml | 5 +++--
 paths/automations/update.yaml | 5 +++--
 3 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/doc/compiled.json b/doc/compiled.json
index c08034f8..3b534f17 100644
--- a/doc/compiled.json
+++ b/doc/compiled.json
@@ -31445,7 +31445,7 @@
                     ]
                   },
                   "project_ids": {
-                    "description": "List of project IDs to associate with the automation.\nCurrently, only the first ID in the array is used.\nThe array format leaves room for future support of multiple projects.\n",
+                    "description": "List of project IDs to associate with the automation.\nProviding more than one project ID requires the `advanced_job_automation`\nplan feature; accounts without this feature receive a 422 response with\nerror field `project_ids`.\n",
                     "type": "array",
                     "items": {
                       "type": "string"
@@ -31674,7 +31674,7 @@
                     ]
                   },
                   "project_ids": {
-                    "description": "List of project IDs to associate with the automation.\nCurrently, only the first ID in the array is used.\nThe array format leaves room for future support of multiple projects.\n",
+                    "description": "List of project IDs to associate with the automation.\nProviding more than one project ID requires the `advanced_job_automation`\nplan feature; accounts without this feature receive a 422 response with\nerror field `project_ids`.\n",
                     "type": "array",
                     "items": {
                       "type": "string"
diff --git a/paths/automations/create.yaml b/paths/automations/create.yaml
index c1619eac..24e87c06 100644
--- a/paths/automations/create.yaml
+++ b/paths/automations/create.yaml
@@ -33,8 +33,9 @@ requestBody:
           project_ids:
             description: |
               List of project IDs to associate with the automation.
-              Currently, only the first ID in the array is used.
-              The array format leaves room for future support of multiple projects.
+              Providing more than one project ID requires the `advanced_job_automation`
+              plan feature; accounts without this feature receive a 422 response with
+              error field `project_ids`.
             type: array
             items:
               type: string
diff --git a/paths/automations/update.yaml b/paths/automations/update.yaml
index c3eaa830..9dc30d06 100644
--- a/paths/automations/update.yaml
+++ b/paths/automations/update.yaml
@@ -34,8 +34,9 @@ requestBody:
           project_ids:
             description: |
               List of project IDs to associate with the automation.
-              Currently, only the first ID in the array is used.
-              The array format leaves room for future support of multiple projects.
+              Providing more than one project ID requires the `advanced_job_automation`
+              plan feature; accounts without this feature receive a 422 response with
+              error field `project_ids`.
             type: array
             items:
               type: string