@workbuddy/sdk-js-vnext 1.0.87 → 1.0.89

package/index.d.ts

@@ -1703,6 +1703,41 @@ export interface WorkBuddySettingsStageStatusesListParams extends WorkBuddyReque
 
 export interface WorkBuddySettingsTagsListParams extends WorkBuddyRequestParams {}
 
+export interface WorkBuddySettingsTagsUpsertParams extends WorkBuddyRequestParams {
+  type: 'service-type' | 'service-scope' | 'work-categories';
+  /**
+   * Display name
+   */
+  name: string;
+
+  color?:
+    | '#1abc9c'
+    | '#16a085'
+    | '#f1c40f'
+    | '#f39c12'
+    | '#2ecc71'
+    | '#27ae60'
+    | '#e67e22'
+    | '#d35400'
+    | '#3498db'
+    | '#2980b9'
+    | '#e74c3c'
+    | '#c0392b'
+    | '#9b59b6'
+    | '#8e44ad'
+    | '#bdc3c7'
+    | '#34495e'
+    | '#2c3e50'
+    | '#95a5a6'
+    | '#7f8c8d'
+    | '#ec87bf'
+    | '#d870ad'
+    | '#f69785'
+    | '#9ba37e'
+    | '#b49255'
+    | '#a94136';
+}
+
 export interface WorkBuddySettingsZonesListParams extends WorkBuddyRequestParams {}
 
 export interface WorkBuddySettingsWorkTypesListParams extends WorkBuddyRequestParams {}
@@ -2942,19 +2977,6 @@ export interface WorkBuddyCrmCustomersUpdateParams extends WorkBuddyRequestParam
    */
   integrationId?: string;
 
-  address?: {
-    name?: string;
-    street1?: string;
-    street2?: string;
-    suburb?: string;
-    state?: string;
-    postalCode?: string;
-    country?: string;
-    lat?: number;
-    lgn?: number;
-    timezone?: string;
-  };
-
   primaryContact?: { id: string; name?: string; type?: string };
 
   primarySite?: Record<string, unknown>;
@@ -3212,19 +3234,6 @@ export interface WorkBuddyCrmContractorsUpdateParams extends WorkBuddyRequestPar
    */
   integrationId?: string;
 
-  address?: {
-    name?: string;
-    street1?: string;
-    street2?: string;
-    suburb?: string;
-    state?: string;
-    postalCode?: string;
-    country?: string;
-    lat?: number;
-    lgn?: number;
-    timezone?: string;
-  };
-
   primaryContact?: { id: string; name?: string; type?: string };
 
   primarySite?: Record<string, unknown>;
@@ -3476,19 +3485,6 @@ export interface WorkBuddyCrmSuppliersUpdateParams extends WorkBuddyRequestParam
    */
   integrationId?: string;
 
-  address?: {
-    name?: string;
-    street1?: string;
-    street2?: string;
-    suburb?: string;
-    state?: string;
-    postalCode?: string;
-    country?: string;
-    lat?: number;
-    lgn?: number;
-    timezone?: string;
-  };
-
   primaryContact?: { id: string; name?: string; type?: string };
 
   primarySite?: Record<string, unknown>;
@@ -5624,7 +5620,37 @@ export type WorkBuddySettingsStageStatusesListResponse = {
     displayOptions: { showInContractorPortal: boolean; showInFieldApp: boolean };
   }[];
 };
-export type WorkBuddySettingsTagsListResponse = { items: { id: string; name: string; color?: string }[] };
+export type WorkBuddySettingsTagsListResponse = {
+  items: { id: string; name: string; color?: string; type?: string }[];
+  colors: (
+    | '#1abc9c'
+    | '#16a085'
+    | '#f1c40f'
+    | '#f39c12'
+    | '#2ecc71'
+    | '#27ae60'
+    | '#e67e22'
+    | '#d35400'
+    | '#3498db'
+    | '#2980b9'
+    | '#e74c3c'
+    | '#c0392b'
+    | '#9b59b6'
+    | '#8e44ad'
+    | '#bdc3c7'
+    | '#34495e'
+    | '#2c3e50'
+    | '#95a5a6'
+    | '#7f8c8d'
+    | '#ec87bf'
+    | '#d870ad'
+    | '#f69785'
+    | '#9ba37e'
+    | '#b49255'
+    | '#a94136'
+  )[];
+};
+export type WorkBuddySettingsTagsUpsertResponse = { item: { id: string; name: string; color?: string; type?: string } };
 export type WorkBuddySettingsZonesListResponse = { items: { id: string; name: string }[] };
 export type WorkBuddySettingsWorkTypesListResponse = { items: { id: string; name: string }[] };
 export type WorkBuddySettingsTemplatesEmailListEmailTemplatesResponse = {
@@ -8384,7 +8410,7 @@ export interface WorkBuddySettingsPricebooksResource {
 
 export interface WorkBuddySettingsStageStatusesResource {
   /**
-   * Retrieve all stage statuses configured for the tenant (Settings > Stage Status).
+   * Retrieve active stage statuses configured for the tenant (Settings > Stage Status). Soft-deleted statuses are omitted.
 Each item is a workflow state a stage (work order) can use (e.g. New, Dispatched, En Route, On Site, Completed, Finalised).
 
 Response fields include:
@@ -8409,13 +8435,22 @@ Requires scope: settings:read
 
 export interface WorkBuddySettingsTagsResource {
   /**
-   * Retrieve all active tags (labels) configured. Use the optional `type` query parameter to filter by label type. Defaults to `job` if not specified. Supported types: job, scheduling, quote, customer, user, overheads, form, finance, system, work-order-system, account, contact, zone, work-categories, lead-source, lead, opportunity, opportunity-lost, project, project-type, payment-type, file, asset, item-location, task, phase, site, service-type, subscriptions, agreement, work, integration-types, flag-category.
+   * Retrieve all active tags (labels) configured. Use the optional `type` query parameter to filter by label type. Defaults to `job` if not specified. `colors` is the Settings label-picker palette used by PUT /settings/tags. Supported types: job, scheduling, quote, customer, user, overheads, form, finance, system, work-order-system, account, contact, zone, work-categories, lead-source, lead, opportunity, opportunity-lost, project, project-type, payment-type, file, asset, item-location, task, phase, site, service-type, service-scope, subscriptions, agreement, work, integration-types, flag-category.
    * Operation: PublicApiTagController_list
    */
   list<TResponse = WorkBuddySettingsTagsListResponse>(
     params?: WorkBuddySettingsTagsListParams,
     options?: WorkBuddyRequestOptions
   ): Promise<TResponse>;
+
+  /**
+   * Create a tag, or return the existing active tag with the same type and name (case-insensitive). Limited to service-type, service-scope, and work-categories. Optional color must be a Settings label-picker hex; omitted color is chosen from that palette. Does not change color on an existing tag. Requires settings:tags:write — not settings:write.
+   * Operation: PublicApiTagController_upsert
+   */
+  upsert<TResponse = WorkBuddySettingsTagsUpsertResponse>(
+    params: WorkBuddySettingsTagsUpsertParams,
+    options?: WorkBuddyRequestOptions
+  ): Promise<TResponse>;
 }
 
 export interface WorkBuddySettingsZonesResource {

package/index.js

@@ -643,7 +643,7 @@ export class WorkBuddyClient {
       },
       stageStatuses: {
         /**
-   * Retrieve all stage statuses configured for the tenant (Settings > Stage Status).
+   * Retrieve active stage statuses configured for the tenant (Settings > Stage Status). Soft-deleted statuses are omitted.
 Each item is a workflow state a stage (work order) can use (e.g. New, Dispatched, En Route, On Site, Completed, Finalised).
 
 Response fields include:
@@ -664,10 +664,15 @@ Requires scope: settings:read
       },
       tags: {
         /**
-         * Retrieve all active tags (labels) configured. Use the optional `type` query parameter to filter by label type. Defaults to `job` if not specified. Supported types: job, scheduling, quote, customer, user, overheads, form, finance, system, work-order-system, account, contact, zone, work-categories, lead-source, lead, opportunity, opportunity-lost, project, project-type, payment-type, file, asset, item-location, task, phase, site, service-type, subscriptions, agreement, work, integration-types, flag-category.
+         * Retrieve all active tags (labels) configured. Use the optional `type` query parameter to filter by label type. Defaults to `job` if not specified. `colors` is the Settings label-picker palette used by PUT /settings/tags. Supported types: job, scheduling, quote, customer, user, overheads, form, finance, system, work-order-system, account, contact, zone, work-categories, lead-source, lead, opportunity, opportunity-lost, project, project-type, payment-type, file, asset, item-location, task, phase, site, service-type, service-scope, subscriptions, agreement, work, integration-types, flag-category.
          * Operation: PublicApiTagController_list
          */
         list: (params = {}, options = {}) => this.request('PublicApiTagController_list', params, options),
+        /**
+         * Create a tag, or return the existing active tag with the same type and name (case-insensitive). Limited to service-type, service-scope, and work-categories. Optional color must be a Settings label-picker hex; omitted color is chosen from that palette. Does not change color on an existing tag. Requires settings:tags:write — not settings:write.
+         * Operation: PublicApiTagController_upsert
+         */
+        upsert: (params = {}, options = {}) => this.request('PublicApiTagController_upsert', params, options),
       },
       zones: {
         /**
@@ -2219,7 +2224,7 @@ export const operations = [
     actionName: 'list',
     displayName: 'List stage statuses',
     description:
-      'Retrieve all stage statuses configured for the tenant (Settings > Stage Status).\nEach item is a workflow state a stage (work order) can use (e.g. New, Dispatched, En Route, On Site, Completed, Finalised).\n\nResponse fields include:\n- identity: id, name, systemName, systemStatus, sortOrder\n- description (nullable)\n- activityOptions: shareWithCustomer, shareWithField (always present; unset = false)\n- displayOptions: showInContractorPortal, showInFieldApp (always present)\n\nDisplay Options rules (match Settings UI):\n- Only systemStatus On Hold or In Progress support display options; other systemStatus values return both flags as false\n- showInFieldApp is not configurable for In Progress and is always false\n- When supported and not configured, visibility defaults to true (Settings UI default)\n\nRequires scope: settings:read',
+      'Retrieve active stage statuses configured for the tenant (Settings > Stage Status). Soft-deleted statuses are omitted.\nEach item is a workflow state a stage (work order) can use (e.g. New, Dispatched, En Route, On Site, Completed, Finalised).\n\nResponse fields include:\n- identity: id, name, systemName, systemStatus, sortOrder\n- description (nullable)\n- activityOptions: shareWithCustomer, shareWithField (always present; unset = false)\n- displayOptions: showInContractorPortal, showInFieldApp (always present)\n\nDisplay Options rules (match Settings UI):\n- Only systemStatus On Hold or In Progress support display options; other systemStatus values return both flags as false\n- showInFieldApp is not configurable for In Progress and is always false\n- When supported and not configured, visibility defaults to true (Settings UI default)\n\nRequires scope: settings:read',
     method: 'GET',
     path: '/settings/stage-statuses',
     pathParams: [],
@@ -2232,13 +2237,26 @@ export const operations = [
     actionName: 'list',
     displayName: 'List tags',
     description:
-      'Retrieve all active tags (labels) configured. Use the optional `type` query parameter to filter by label type. Defaults to `job` if not specified. Supported types: job, scheduling, quote, customer, user, overheads, form, finance, system, work-order-system, account, contact, zone, work-categories, lead-source, lead, opportunity, opportunity-lost, project, project-type, payment-type, file, asset, item-location, task, phase, site, service-type, subscriptions, agreement, work, integration-types, flag-category.',
+      'Retrieve all active tags (labels) configured. Use the optional `type` query parameter to filter by label type. Defaults to `job` if not specified. `colors` is the Settings label-picker palette used by PUT /settings/tags. Supported types: job, scheduling, quote, customer, user, overheads, form, finance, system, work-order-system, account, contact, zone, work-categories, lead-source, lead, opportunity, opportunity-lost, project, project-type, payment-type, file, asset, item-location, task, phase, site, service-type, service-scope, subscriptions, agreement, work, integration-types, flag-category.',
     method: 'GET',
     path: '/settings/tags',
     pathParams: [],
     queryParams: [],
     hasRequestBody: false,
   },
+  {
+    operationId: 'PublicApiTagController_upsert',
+    resourcePath: ['settings', 'tags'],
+    actionName: 'upsert',
+    displayName: 'Upsert a tag',
+    description:
+      'Create a tag, or return the existing active tag with the same type and name (case-insensitive). Limited to service-type, service-scope, and work-categories. Optional color must be a Settings label-picker hex; omitted color is chosen from that palette. Does not change color on an existing tag. Requires settings:tags:write — not settings:write.',
+    method: 'PUT',
+    path: '/settings/tags',
+    pathParams: [],
+    queryParams: [],
+    hasRequestBody: true,
+  },
   {
     operationId: 'PublicApiZoneController_list',
     resourcePath: ['settings', 'zones'],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workbuddy/sdk-js-vnext",
-  "version": "1.0.87",
+  "version": "1.0.89",
   "description": "WorkBuddy Public API JavaScript client",
   "license": "MIT",
   "type": "module",