From d2749d4d08890623db68a7bf0fd96fb36baecb78 Mon Sep 17 00:00:00 2001
From: "n8n-assistant[bot]"
 <100856346+n8n-assistant[bot]@users.noreply.github.com>
Date: Tue, 13 Jan 2026 16:23:47 +0000
Subject: [PATCH] chore: Update Public API schema (#4093)

Co-authored-by: tomi <10324676+tomi@users.noreply.github.com>
Co-authored-by: Kartik Balasubramanian <22399046+HumanistSerif@users.noreply.github.com>
---
 docs/api/v1/openapi.yml | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/docs/api/v1/openapi.yml b/docs/api/v1/openapi.yml
index cb6ef749c..836ea47f5 100644
--- a/docs/api/v1/openapi.yml
+++ b/docs/api/v1/openapi.yml
@@ -581,8 +581,8 @@ paths:
       x-eov-operation-handler: v1/handlers/workflows/workflows.handler
       tags:
         - Workflow
-      summary: Retrieves a workflow
-      description: Retrieves a workflow.
+      summary: Retrieve a workflow
+      description: Retrieve a workflow.
       parameters:
         - name: excludePinnedData
           in: query
@@ -609,7 +609,7 @@ paths:
       tags:
         - Workflow
       summary: Delete a workflow
-      description: Deletes a workflow.
+      description: Delete a workflow.
       parameters:
         - $ref: '#/components/parameters/workflowId'
       responses:
@@ -629,7 +629,7 @@ paths:
       tags:
         - Workflow
       summary: Update a workflow
-      description: Update a workflow. If the workflow is active, the updated version will be automatically reactivated.
+      description: Update a workflow. If the workflow is published, the updated version will be automatically re-published.
       parameters:
         - $ref: '#/components/parameters/workflowId'
       requestBody:
@@ -686,12 +686,12 @@ paths:
       x-eov-operation-handler: v1/handlers/workflows/workflows.handler
       tags:
         - Workflow
-      summary: Activate a workflow
-      description: Active a workflow.
+      summary: Publish a workflow
+      description: Publish a workflow. In n8n v1, this action was termed activating a workflow.
       parameters:
         - $ref: '#/components/parameters/workflowId'
       requestBody:
-        description: Optional parameters for workflow activation.
+        description: Optional parameters to publish the workflow.
         content:
           application/json:
             schema:
@@ -699,7 +699,7 @@ paths:
               properties:
                 versionId:
                   type: string
-                  description: The specific version ID to activate. If not provided, activates the latest version.
+                  description: The specific version ID to activate or publish. If not provided, the latest version is used.
                 name:
                   type: string
                   description: Optional name for the workflow version during activation.
@@ -747,8 +747,8 @@ paths:
       x-eov-operation-handler: v1/handlers/workflows/workflows.handler
       tags:
         - Workflow
-      summary: Transfer a workflow to another project.
-      description: Transfer a workflow to another project.
+      summary: Transfer a workflow to another project
+      description: Transfer a workflow to another project
       parameters:
         - $ref: '#/components/parameters/workflowId'
       requestBody: