@workbuddy/piece-workbuddy-vnext 1.0.4 → 1.0.6

package/src/lib/actions/{stages->-tasks.ts → stages-tasks.ts}

@@ -5,17 +5,17 @@ import { workbuddyAuth, getAccessToken } from '../auth';
 export const PublicStageTasksController_list = createAction({
   name: 'PublicStageTasksController_list',
   auth: workbuddyAuth,
-  displayName: 'List tasks',
+  displayName: 'List tasks (Stages)',
   description: '',
   props: {
     stageId: Property.ShortText({
       displayName: 'Stage Id',
-      description: '',
+      description: 'Stage ID or stage number',
       required: true,
     }),
     jobId: Property.ShortText({
       displayName: 'Job Id',
-      description: '',
+      description: 'Job ID or job number (e.g. J12345)',
       required: true,
     }),
   },
@@ -42,27 +42,27 @@ export const PublicStageTasksController_list = createAction({
 export const PublicStageTasksController_create = createAction({
   name: 'PublicStageTasksController_create',
   auth: workbuddyAuth,
-  displayName: 'Create task',
+  displayName: 'Create task (Stages)',
   description: '',
   props: {
     stageId: Property.ShortText({
       displayName: 'Stage Id',
-      description: '',
+      description: 'Stage ID or stage number',
       required: true,
     }),
     jobId: Property.ShortText({
       displayName: 'Job Id',
-      description: '',
+      description: 'Job ID or job number (e.g. J12345)',
       required: true,
     }),
     name: Property.ShortText({
       displayName: 'Name',
-      description: '',
+      description: 'Display name',
       required: true,
     }),
     description: Property.LongText({
       displayName: 'Description',
-      description: '',
+      description: 'Detailed description',
       required: false,
     }),
     target: Property.StaticDropdown({
@@ -79,17 +79,17 @@ export const PublicStageTasksController_create = createAction({
     }),
     assigneeId: Property.ShortText({
       displayName: 'Assignee Id',
-      description: '',
+      description: 'assignee ID',
       required: false,
     }),
     dueDate: Property.DateTime({
       displayName: 'Due Date',
-      description: '',
+      description: 'Due date (ISO 8601 datetime)',
       required: false,
     }),
     tagIds: Property.Array({
       displayName: 'Tag Ids',
-      description: '',
+      description: 'Array of tag IDs (comma-separated, e.g. "id1,id2") — use /settings/tags to look up',
       required: false,
     }),
     evidenceOptions: Property.Json({
@@ -99,7 +99,7 @@ export const PublicStageTasksController_create = createAction({
     }),
     sharing: Property.Json({
       displayName: 'Sharing',
-      description: '',
+      description: 'Sharing options — control visibility to customer portal and field app',
       required: false,
     }),
   },
@@ -109,7 +109,7 @@ export const PublicStageTasksController_create = createAction({
 
     const url = `${baseUrl}/api/v2/public/jobs/${context.propsValue.jobId}/stages/${context.propsValue.stageId}/tasks`;
 
-    const body = {
+    const rawBody: Record<string, unknown> = {
       name: context.propsValue.name,
       description: context.propsValue.description,
       target: context.propsValue.target,
@@ -119,6 +119,8 @@ export const PublicStageTasksController_create = createAction({
       evidenceOptions: context.propsValue.evidenceOptions,
       sharing: context.propsValue.sharing,
     };
+
+    const body = rawBody;
     const response = await httpClient.sendRequest({
       method: HttpMethod.POST,
       url: `${baseUrl}/api/v2/public/jobs/${context.propsValue.jobId}/stages/${context.propsValue.stageId}/tasks`,
@@ -137,12 +139,12 @@ export const PublicStageTasksController_create = createAction({
 export const PublicStageTasksController_getById = createAction({
   name: 'PublicStageTasksController_getById',
   auth: workbuddyAuth,
-  displayName: 'Get task by ID',
+  displayName: 'Get task by ID (Stages)',
   description: '',
   props: {
     stageId: Property.ShortText({
       displayName: 'Stage Id',
-      description: '',
+      description: 'Stage ID or stage number',
       required: true,
     }),
     id: Property.ShortText({
@@ -150,16 +152,21 @@ export const PublicStageTasksController_getById = createAction({
       description: 'Task ID',
       required: true,
     }),
+    jobId: Property.ShortText({
+      displayName: 'Job Id',
+      description: '',
+      required: true,
+    }),
   },
   async run(context) {
     const token = await getAccessToken(context.auth);
     const baseUrl = context.auth.props.baseUrl;
 
-    const url = `${baseUrl}/api/v2/public/jobs/{jobId}/stages/${context.propsValue.stageId}/tasks/${context.propsValue.id}`;
+    const url = `${baseUrl}/api/v2/public/jobs/${context.propsValue.jobId}/stages/${context.propsValue.stageId}/tasks/${context.propsValue.id}`;
 
     const response = await httpClient.sendRequest({
       method: HttpMethod.GET,
-      url: `${baseUrl}/api/v2/public/jobs/{jobId}/stages/${context.propsValue.stageId}/tasks/${context.propsValue.id}`,
+      url: `${baseUrl}/api/v2/public/jobs/${context.propsValue.jobId}/stages/${context.propsValue.stageId}/tasks/${context.propsValue.id}`,
       headers: {
         Authorization: `Bearer ${token}`,
         'Content-Type': 'application/json',
@@ -174,12 +181,12 @@ export const PublicStageTasksController_getById = createAction({
 export const PublicStageTasksController_update = createAction({
   name: 'PublicStageTasksController_update',
   auth: workbuddyAuth,
-  displayName: 'Update task',
+  displayName: 'Update task (Stages)',
   description: '',
   props: {
     stageId: Property.ShortText({
       displayName: 'Stage Id',
-      description: '',
+      description: 'Stage ID or stage number',
       required: true,
     }),
     id: Property.ShortText({
@@ -187,19 +194,24 @@ export const PublicStageTasksController_update = createAction({
       description: 'Task ID',
       required: true,
     }),
+    jobId: Property.ShortText({
+      displayName: 'Job Id',
+      description: '',
+      required: true,
+    }),
     name: Property.ShortText({
       displayName: 'Name',
-      description: '',
+      description: 'Display name',
       required: false,
     }),
     description: Property.LongText({
       displayName: 'Description',
-      description: '',
+      description: 'Detailed description',
       required: false,
     }),
     status: Property.StaticDropdown({
       displayName: 'Status',
-      description: '',
+      description: 'Status filter',
       required: false,
       options: {
         options: [
@@ -222,12 +234,12 @@ export const PublicStageTasksController_update = createAction({
     }),
     assigneeId: Property.ShortText({
       displayName: 'Assignee Id',
-      description: '',
+      description: 'assignee ID',
       required: false,
     }),
     dueDate: Property.ShortText({
       displayName: 'Due Date',
-      description: '',
+      description: 'Due date (ISO 8601 datetime)',
       required: false,
     }),
     completedOn: Property.ShortText({
@@ -237,17 +249,27 @@ export const PublicStageTasksController_update = createAction({
     }),
     completedById: Property.ShortText({
       displayName: 'Completed By Id',
+      description: 'completed by ID',
+      required: false,
+    }),
+    tagsSet: Property.Array({
+      displayName: 'Tags Set',
       description: '',
       required: false,
     }),
-    tagIds: Property.Array({
-      displayName: 'Tag Ids',
+    tagsAdd: Property.Array({
+      displayName: 'Tags Add',
+      description: '',
+      required: false,
+    }),
+    tagsRemove: Property.Array({
+      displayName: 'Tags Remove',
       description: '',
       required: false,
     }),
     sharing: Property.Json({
       displayName: 'Sharing',
-      description: '',
+      description: 'Sharing options — control visibility to customer portal and field app',
       required: false,
     }),
   },
@@ -255,7 +277,7 @@ export const PublicStageTasksController_update = createAction({
     const token = await getAccessToken(context.auth);
     const baseUrl = context.auth.props.baseUrl;
 
-    const url = `${baseUrl}/api/v2/public/jobs/{jobId}/stages/${context.propsValue.stageId}/tasks/${context.propsValue.id}`;
+    const url = `${baseUrl}/api/v2/public/jobs/${context.propsValue.jobId}/stages/${context.propsValue.stageId}/tasks/${context.propsValue.id}`;
 
     // Build body with only defined values (for partial updates)
     const rawBody: Record<string, unknown> = {
@@ -267,15 +289,29 @@ export const PublicStageTasksController_update = createAction({
       dueDate: context.propsValue.dueDate,
       completedOn: context.propsValue.completedOn,
       completedById: context.propsValue.completedById,
-      tagIds: context.propsValue.tagIds,
       sharing: context.propsValue.sharing,
     };
+    {
+      const tags = Object.fromEntries(
+        Object.entries({
+          set: context.propsValue.tagsSet,
+          add: context.propsValue.tagsAdd,
+          remove: context.propsValue.tagsRemove,
+        }).filter(([_, value]) => value !== undefined)
+      );
+      if (tags.set !== undefined && (tags.add !== undefined || tags.remove !== undefined)) {
+        throw new Error('tags: set is mutually exclusive with add/remove');
+      }
+      if (Object.keys(tags).length > 0) {
+        rawBody.tags = tags;
+      }
+    }
     const body = Object.fromEntries(
       Object.entries(rawBody).filter(([_, v]) => v !== undefined && v !== null && v !== '')
     );
     const response = await httpClient.sendRequest({
       method: HttpMethod.PATCH,
-      url: `${baseUrl}/api/v2/public/jobs/{jobId}/stages/${context.propsValue.stageId}/tasks/${context.propsValue.id}`,
+      url: `${baseUrl}/api/v2/public/jobs/${context.propsValue.jobId}/stages/${context.propsValue.stageId}/tasks/${context.propsValue.id}`,
       headers: {
         Authorization: `Bearer ${token}`,
         'Content-Type': 'application/json',
@@ -291,12 +327,12 @@ export const PublicStageTasksController_update = createAction({
 export const PublicStageTasksController_delete = createAction({
   name: 'PublicStageTasksController_delete',
   auth: workbuddyAuth,
-  displayName: 'Delete task',
+  displayName: 'Delete task (Stages)',
   description: '',
   props: {
     stageId: Property.ShortText({
       displayName: 'Stage Id',
-      description: '',
+      description: 'Stage ID or stage number',
       required: true,
     }),
     id: Property.ShortText({
@@ -304,16 +340,21 @@ export const PublicStageTasksController_delete = createAction({
       description: 'Task ID',
       required: true,
     }),
+    jobId: Property.ShortText({
+      displayName: 'Job Id',
+      description: '',
+      required: true,
+    }),
   },
   async run(context) {
     const token = await getAccessToken(context.auth);
     const baseUrl = context.auth.props.baseUrl;
 
-    const url = `${baseUrl}/api/v2/public/jobs/{jobId}/stages/${context.propsValue.stageId}/tasks/${context.propsValue.id}`;
+    const url = `${baseUrl}/api/v2/public/jobs/${context.propsValue.jobId}/stages/${context.propsValue.stageId}/tasks/${context.propsValue.id}`;
 
     const response = await httpClient.sendRequest({
       method: HttpMethod.DELETE,
-      url: `${baseUrl}/api/v2/public/jobs/{jobId}/stages/${context.propsValue.stageId}/tasks/${context.propsValue.id}`,
+      url: `${baseUrl}/api/v2/public/jobs/${context.propsValue.jobId}/stages/${context.propsValue.stageId}/tasks/${context.propsValue.id}`,
       headers: {
         Authorization: `Bearer ${token}`,
         'Content-Type': 'application/json',
@@ -328,12 +369,12 @@ export const PublicStageTasksController_delete = createAction({
 export const PublicStageTasksController_submitEvidence = createAction({
   name: 'PublicStageTasksController_submitEvidence',
   auth: workbuddyAuth,
-  displayName: 'Submit task evidence',
+  displayName: 'Submit task evidence (Stages)',
   description: '',
   props: {
     stageId: Property.ShortText({
       displayName: 'Stage Id',
-      description: '',
+      description: 'Stage ID or stage number',
       required: true,
     }),
     id: Property.ShortText({
@@ -341,24 +382,29 @@ export const PublicStageTasksController_submitEvidence = createAction({
       description: 'Task ID',
       required: true,
     }),
+    jobId: Property.ShortText({
+      displayName: 'Job Id',
+      description: '',
+      required: true,
+    }),
     signatureAttachmentIds: Property.Array({
       displayName: 'Signature Attachment Ids',
-      description: '',
+      description: 'Array of signature attachment IDs (comma-separated in CLI, e.g. "id1,id2")',
       required: false,
     }),
     beforePhotoAttachmentIds: Property.Array({
       displayName: 'Before Photo Attachment Ids',
-      description: '',
+      description: 'Array of before photo attachment IDs (comma-separated in CLI, e.g. "id1,id2")',
       required: false,
     }),
     duringPhotoAttachmentIds: Property.Array({
       displayName: 'During Photo Attachment Ids',
-      description: '',
+      description: 'Array of during photo attachment IDs (comma-separated in CLI, e.g. "id1,id2")',
       required: false,
     }),
     afterPhotoAttachmentIds: Property.Array({
       displayName: 'After Photo Attachment Ids',
-      description: '',
+      description: 'Array of after photo attachment IDs (comma-separated in CLI, e.g. "id1,id2")',
       required: false,
     }),
     comment: Property.ShortText({
@@ -373,17 +419,17 @@ export const PublicStageTasksController_submitEvidence = createAction({
     }),
     formResponseId: Property.ShortText({
       displayName: 'Form Response Id',
-      description: '',
+      description: 'form response ID',
       required: false,
     }),
     fileAttachmentIds: Property.Array({
       displayName: 'File Attachment Ids',
-      description: '',
+      description: 'Array of file attachment IDs (comma-separated in CLI, e.g. "id1,id2")',
       required: false,
     }),
     additionalFileAttachmentIds: Property.Array({
       displayName: 'Additional File Attachment Ids',
-      description: '',
+      description: 'Array of additional file attachment IDs (comma-separated in CLI, e.g. "id1,id2")',
       required: false,
     }),
     complete: Property.Checkbox({
@@ -397,9 +443,9 @@ export const PublicStageTasksController_submitEvidence = createAction({
     const token = await getAccessToken(context.auth);
     const baseUrl = context.auth.props.baseUrl;
 
-    const url = `${baseUrl}/api/v2/public/jobs/{jobId}/stages/${context.propsValue.stageId}/tasks/${context.propsValue.id}/evidence`;
+    const url = `${baseUrl}/api/v2/public/jobs/${context.propsValue.jobId}/stages/${context.propsValue.stageId}/tasks/${context.propsValue.id}/evidence`;
 
-    const body = {
+    const rawBody: Record<string, unknown> = {
       signatureAttachmentIds: context.propsValue.signatureAttachmentIds,
       beforePhotoAttachmentIds: context.propsValue.beforePhotoAttachmentIds,
       duringPhotoAttachmentIds: context.propsValue.duringPhotoAttachmentIds,
@@ -411,9 +457,11 @@ export const PublicStageTasksController_submitEvidence = createAction({
       additionalFileAttachmentIds: context.propsValue.additionalFileAttachmentIds,
       complete: context.propsValue.complete,
     };
+
+    const body = rawBody;
     const response = await httpClient.sendRequest({
       method: HttpMethod.POST,
-      url: `${baseUrl}/api/v2/public/jobs/{jobId}/stages/${context.propsValue.stageId}/tasks/${context.propsValue.id}/evidence`,
+      url: `${baseUrl}/api/v2/public/jobs/${context.propsValue.jobId}/stages/${context.propsValue.stageId}/tasks/${context.propsValue.id}/evidence`,
       headers: {
         Authorization: `Bearer ${token}`,
         'Content-Type': 'application/json',

package/src/lib/actions/stages.d.ts

@@ -23,8 +23,12 @@ export declare const PublicJobStageController_update: import("@activepieces/piec
     startDate: import("@activepieces/pieces-framework").ShortTextProperty<false>;
     dueDate: import("@activepieces/pieces-framework").ShortTextProperty<false>;
     notes: import("@activepieces/pieces-framework").LongTextProperty<false>;
-    tags: import("@activepieces/pieces-framework").JsonProperty<false>;
-    schedulingTags: import("@activepieces/pieces-framework").JsonProperty<false>;
+    tagsSet: import("@activepieces/pieces-framework").ArrayProperty<false>;
+    tagsAdd: import("@activepieces/pieces-framework").ArrayProperty<false>;
+    tagsRemove: import("@activepieces/pieces-framework").ArrayProperty<false>;
+    schedulingTagsSet: import("@activepieces/pieces-framework").ArrayProperty<false>;
+    schedulingTagsAdd: import("@activepieces/pieces-framework").ArrayProperty<false>;
+    schedulingTagsRemove: import("@activepieces/pieces-framework").ArrayProperty<false>;
     customFields: import("@activepieces/pieces-framework").JsonProperty<false>;
 }>;
 export declare const PublicJobStageController_delete: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").CustomAuthProperty<{

package/src/lib/actions/stages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stages.d.ts","sourceRoot":"","sources":["stages.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;EA4E1C,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;EAqF1C,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;EA8B1C,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;;;EA8B5C,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;;;;;EA6C5C,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;;;;EAuC5C,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;EAuC1C,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;;EAyD3C,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;EA8B3C,CAAC"}
+{"version":3,"file":"stages.d.ts","sourceRoot":"","sources":["stages.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;EA8E1C,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;EAwI1C,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;EA8B1C,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;;;EA8B5C,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;;;;;EA+C5C,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;;;;EAyC5C,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;EAyC1C,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;;EA2D3C,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;EA8B3C,CAAC"}

package/src/lib/actions/stages.js

@@ -12,42 +12,42 @@ exports.PublicJobStageController_create = (0, pieces_framework_1.createAction)({
     props: {
         jobId: pieces_framework_1.Property.ShortText({
             displayName: 'Job Id',
-            description: '',
+            description: 'Job ID or job number (e.g. J12345)',
             required: true,
         }),
         name: pieces_framework_1.Property.ShortText({
             displayName: 'Name',
-            description: '',
+            description: 'Display name',
             required: true,
         }),
         workCategoryId: pieces_framework_1.Property.ShortText({
             displayName: 'Work Category Id',
-            description: '',
+            description: 'Work category ID — use /settings/work-types to look up',
             required: false,
         }),
         sequence: pieces_framework_1.Property.Number({
             displayName: 'Sequence',
-            description: '',
+            description: 'Display order / sequence number',
             required: false,
         }),
         startDate: pieces_framework_1.Property.ShortText({
             displayName: 'Start Date',
-            description: '',
+            description: 'Start date (ISO 8601 datetime)',
             required: false,
         }),
         dueDate: pieces_framework_1.Property.ShortText({
             displayName: 'Due Date',
-            description: '',
+            description: 'Due date (ISO 8601 datetime)',
             required: false,
         }),
         notes: pieces_framework_1.Property.LongText({
             displayName: 'Notes',
-            description: '',
+            description: 'Additional notes or comments',
             required: false,
         }),
         customFields: pieces_framework_1.Property.Json({
             displayName: 'Custom Fields',
-            description: '',
+            description: 'Custom fields as key-value pairs — validated against tenant field definitions',
             required: false,
         }),
     },
@@ -55,7 +55,7 @@ exports.PublicJobStageController_create = (0, pieces_framework_1.createAction)({
         const token = await (0, auth_1.getAccessToken)(context.auth);
         const baseUrl = context.auth.props.baseUrl;
         const url = `${baseUrl}/api/v2/public/stages`;
-        const body = {
+        const rawBody = {
             jobId: context.propsValue.jobId,
             name: context.propsValue.name,
             workCategoryId: context.propsValue.workCategoryId,
@@ -65,6 +65,7 @@ exports.PublicJobStageController_create = (0, pieces_framework_1.createAction)({
             notes: context.propsValue.notes,
             customFields: context.propsValue.customFields,
         };
+        const body = rawBody;
         const response = await pieces_common_1.httpClient.sendRequest({
             method: pieces_common_1.HttpMethod.POST,
             url: `${baseUrl}/api/v2/public/stages`,
@@ -91,42 +92,62 @@ exports.PublicJobStageController_update = (0, pieces_framework_1.createAction)({
         }),
         name: pieces_framework_1.Property.ShortText({
             displayName: 'Name',
-            description: '',
+            description: 'Display name',
             required: false,
         }),
         workCategoryId: pieces_framework_1.Property.ShortText({
             displayName: 'Work Category Id',
-            description: '',
+            description: 'Work category ID — use /settings/work-types to look up',
             required: false,
         }),
         startDate: pieces_framework_1.Property.ShortText({
             displayName: 'Start Date',
-            description: '',
+            description: 'Start date (ISO 8601 datetime)',
             required: false,
         }),
         dueDate: pieces_framework_1.Property.ShortText({
             displayName: 'Due Date',
-            description: '',
+            description: 'Due date (ISO 8601 datetime)',
             required: false,
         }),
         notes: pieces_framework_1.Property.LongText({
             displayName: 'Notes',
+            description: 'Additional notes or comments',
+            required: false,
+        }),
+        tagsSet: pieces_framework_1.Property.Array({
+            displayName: 'Tags Set',
+            description: '',
+            required: false,
+        }),
+        tagsAdd: pieces_framework_1.Property.Array({
+            displayName: 'Tags Add',
+            description: '',
+            required: false,
+        }),
+        tagsRemove: pieces_framework_1.Property.Array({
+            displayName: 'Tags Remove',
+            description: '',
+            required: false,
+        }),
+        schedulingTagsSet: pieces_framework_1.Property.Array({
+            displayName: 'Scheduling Tags Set',
             description: '',
             required: false,
         }),
-        tags: pieces_framework_1.Property.Json({
-            displayName: 'Tags',
+        schedulingTagsAdd: pieces_framework_1.Property.Array({
+            displayName: 'Scheduling Tags Add',
             description: '',
             required: false,
         }),
-        schedulingTags: pieces_framework_1.Property.Json({
-            displayName: 'Scheduling Tags',
+        schedulingTagsRemove: pieces_framework_1.Property.Array({
+            displayName: 'Scheduling Tags Remove',
             description: '',
             required: false,
         }),
         customFields: pieces_framework_1.Property.Json({
             displayName: 'Custom Fields',
-            description: '',
+            description: 'Custom fields as key-value pairs — validated against tenant field definitions',
             required: false,
         }),
     },
@@ -141,10 +162,35 @@ exports.PublicJobStageController_update = (0, pieces_framework_1.createAction)({
             startDate: context.propsValue.startDate,
             dueDate: context.propsValue.dueDate,
             notes: context.propsValue.notes,
-            tags: context.propsValue.tags,
-            schedulingTags: context.propsValue.schedulingTags,
             customFields: context.propsValue.customFields,
         };
+        {
+            const tags = Object.fromEntries(Object.entries({
+                set: context.propsValue.tagsSet,
+                add: context.propsValue.tagsAdd,
+                remove: context.propsValue.tagsRemove,
+            }).filter(([_, value]) => value !== undefined));
+            if (tags.set !== undefined && (tags.add !== undefined || tags.remove !== undefined)) {
+                throw new Error('tags: set is mutually exclusive with add/remove');
+            }
+            if (Object.keys(tags).length > 0) {
+                rawBody.tags = tags;
+            }
+        }
+        {
+            const schedulingTags = Object.fromEntries(Object.entries({
+                set: context.propsValue.schedulingTagsSet,
+                add: context.propsValue.schedulingTagsAdd,
+                remove: context.propsValue.schedulingTagsRemove,
+            }).filter(([_, value]) => value !== undefined));
+            if (schedulingTags.set !== undefined &&
+                (schedulingTags.add !== undefined || schedulingTags.remove !== undefined)) {
+                throw new Error('schedulingTags: set is mutually exclusive with add/remove');
+            }
+            if (Object.keys(schedulingTags).length > 0) {
+                rawBody.schedulingTags = schedulingTags;
+            }
+        }
         const body = Object.fromEntries(Object.entries(rawBody).filter(([_, v]) => v !== undefined && v !== null && v !== ''));
         const response = await pieces_common_1.httpClient.sendRequest({
             method: pieces_common_1.HttpMethod.PATCH,
@@ -228,12 +274,12 @@ exports.PublicJobStageController_complete = (0, pieces_framework_1.createAction)
         }),
         completedDate: pieces_framework_1.Property.DateTime({
             displayName: 'Completed Date',
-            description: '',
+            description: 'Completion date (ISO 8601 datetime)',
             required: false,
         }),
         notes: pieces_framework_1.Property.LongText({
             displayName: 'Notes',
-            description: '',
+            description: 'Additional notes or comments',
             required: false,
         }),
     },
@@ -241,10 +287,11 @@ exports.PublicJobStageController_complete = (0, pieces_framework_1.createAction)
         const token = await (0, auth_1.getAccessToken)(context.auth);
         const baseUrl = context.auth.props.baseUrl;
         const url = `${baseUrl}/api/v2/public/stages/${context.propsValue.id}/complete`;
-        const body = {
+        const rawBody = {
             completedDate: context.propsValue.completedDate,
             notes: context.propsValue.notes,
         };
+        const body = rawBody;
         const response = await pieces_common_1.httpClient.sendRequest({
             method: pieces_common_1.HttpMethod.POST,
             url: `${baseUrl}/api/v2/public/stages/${context.propsValue.id}/complete`,
@@ -271,7 +318,7 @@ exports.PublicJobStageController_finalise = (0, pieces_framework_1.createAction)
         }),
         finalisedDate: pieces_framework_1.Property.DateTime({
             displayName: 'Finalised Date',
-            description: '',
+            description: 'Finalisation date (ISO 8601 datetime)',
             required: false,
         }),
     },
@@ -279,9 +326,10 @@ exports.PublicJobStageController_finalise = (0, pieces_framework_1.createAction)
         const token = await (0, auth_1.getAccessToken)(context.auth);
         const baseUrl = context.auth.props.baseUrl;
         const url = `${baseUrl}/api/v2/public/stages/${context.propsValue.id}/finalise`;
-        const body = {
+        const rawBody = {
             finalisedDate: context.propsValue.finalisedDate,
         };
+        const body = rawBody;
         const response = await pieces_common_1.httpClient.sendRequest({
             method: pieces_common_1.HttpMethod.POST,
             url: `${baseUrl}/api/v2/public/stages/${context.propsValue.id}/finalise`,
@@ -316,9 +364,10 @@ exports.PublicJobStageController_cancel = (0, pieces_framework_1.createAction)({
         const token = await (0, auth_1.getAccessToken)(context.auth);
         const baseUrl = context.auth.props.baseUrl;
         const url = `${baseUrl}/api/v2/public/stages/${context.propsValue.id}/cancel`;
-        const body = {
+        const rawBody = {
             note: context.propsValue.note,
         };
+        const body = rawBody;
         const response = await pieces_common_1.httpClient.sendRequest({
             method: pieces_common_1.HttpMethod.POST,
             url: `${baseUrl}/api/v2/public/stages/${context.propsValue.id}/cancel`,
@@ -369,10 +418,11 @@ exports.PublicJobStageController_reverse = (0, pieces_framework_1.createAction)(
         const token = await (0, auth_1.getAccessToken)(context.auth);
         const baseUrl = context.auth.props.baseUrl;
         const url = `${baseUrl}/api/v2/public/stages/${context.propsValue.id}/reverse`;
-        const body = {
+        const rawBody = {
             targetStatus: context.propsValue.targetStatus,
             note: context.propsValue.note,
         };
+        const body = rawBody;
         const response = await pieces_common_1.httpClient.sendRequest({
             method: pieces_common_1.HttpMethod.POST,
             url: `${baseUrl}/api/v2/public/stages/${context.propsValue.id}/reverse`,