@workbuddy/sdk-js-vnext 1.0.87 → 1.0.88

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 {}
@@ -5624,7 +5659,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 = {
@@ -8409,13 +8474,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

@@ -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: {
         /**
@@ -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.88",
   "description": "WorkBuddy Public API JavaScript client",
   "license": "MIT",
   "type": "module",