@workbuddy/sdk-js-edge 1.0.0 → 1.0.1

package/index.js

@@ -1,6 +1,6 @@
 const PUBLIC_API_BASE_PATH = '/api/v2/public';
 const DEFAULT_API_VERSION = '2026-01';
-const DEFAULT_TOKEN_URL = 'https://tarek.workbuddy.dev/api/oauth2/token';
+const DEFAULT_TOKEN_URL = 'https://abutanka.workbuddy.io/api/oauth2/token';
 
 export class WorkBuddyApiError extends Error {
   constructor(message, response, data) {
@@ -34,6 +34,22 @@ export class WorkBuddyClient {
     }
 
     this.jobs = {
+      template: {
+        /**
+         * Create a job using a job template. Template-owned fields win over request values before final job validation.
+         * Operation: PublicApiJobController_createFromTemplate
+         */
+        createFromTemplate: (params = {}, options = {}) =>
+          this.request('PublicApiJobController_createFromTemplate', params, options),
+      },
+      status: {
+        /**
+         * Change an existing job status and cascade the change to stages through the job domain command.
+         * Operation: PublicApiJobController_updateStatus
+         */
+        updateStatus: (params = {}, options = {}) =>
+          this.request('PublicApiJobController_updateStatus', params, options),
+      },
       stages: {
         items: {
           /**
@@ -46,12 +62,83 @@ export class WorkBuddyClient {
           /** Iterate raw pages by following cursor pagination for list(). */
           pages: (params = {}, options = {}) =>
             this.paginatePages('PublicApiJobController_getStageItems', params, options),
+          /**
+           * Add one or more catalogue-backed line items to a stage.
+           * Operation: PublicApiJobController_createStageItems
+           */
+          createStageItems: (params = {}, options = {}) =>
+            this.request('PublicApiJobController_createStageItems', params, options),
           /**
            * Get a specific item within a stage.
            * Operation: PublicApiJobController_getStageItem
            */
           getStageItem: (params = {}, options = {}) =>
             this.request('PublicApiJobController_getStageItem', params, options),
+          /**
+           * Update mutable fields on a stage line item.
+           * Operation: PublicApiJobController_updateStageItem
+           */
+          updateStageItem: (params = {}, options = {}) =>
+            this.request('PublicApiJobController_updateStageItem', params, options),
+          /**
+           * Remove or cancel a stage item depending on tenant deletion settings.
+           * Operation: PublicApiJobController_deleteStageItem
+           */
+          deleteStageItem: (params = {}, options = {}) =>
+            this.request('PublicApiJobController_deleteStageItem', params, options),
+        },
+        pendingItems: {
+          status: {
+            /**
+             * Set the dedicated pending-item status. No general item fields are accepted.
+             * Operation: PublicJobStagePendingItemController_updateStatus
+             */
+            updateStatus: (params = {}, options = {}) =>
+              this.request('PublicJobStagePendingItemController_updateStatus', params, options),
+          },
+          approve: {
+            /**
+             * Approve a pending item and promote it to a standard stage item.
+             * Operation: PublicJobStagePendingItemController_approve
+             */
+            approve: (params = {}, options = {}) =>
+              this.request('PublicJobStagePendingItemController_approve', params, options),
+          },
+          /**
+           * List items awaiting approval for a stage.
+           * Operation: PublicJobStagePendingItemController_list
+           */
+          list: (params = {}, options = {}) =>
+            this.request('PublicJobStagePendingItemController_list', params, options),
+          /** Iterate all items by following cursor pagination for list(). */
+          all: (params = {}, options = {}) =>
+            this.paginate('PublicJobStagePendingItemController_list', params, options),
+          /** Iterate raw pages by following cursor pagination for list(). */
+          pages: (params = {}, options = {}) =>
+            this.paginatePages('PublicJobStagePendingItemController_list', params, options),
+          /**
+           * Create one or more items awaiting approval.
+           * Operation: PublicJobStagePendingItemController_create
+           */
+          create: (params = {}, options = {}) =>
+            this.request('PublicJobStagePendingItemController_create', params, options),
+          /**
+           * Get a specific pending item within a stage.
+           * Operation: PublicJobStagePendingItemController_get
+           */
+          get: (params = {}, options = {}) => this.request('PublicJobStagePendingItemController_get', params, options),
+          /**
+           * Update general pending-item fields. Use the status route for itemStatus.
+           * Operation: PublicJobStagePendingItemController_update
+           */
+          update: (params = {}, options = {}) =>
+            this.request('PublicJobStagePendingItemController_update', params, options),
+          /**
+           * Delete or decline a pending item according to tenant deletion settings.
+           * Operation: PublicJobStagePendingItemController_delete
+           */
+          delete: (params = {}, options = {}) =>
+            this.request('PublicJobStagePendingItemController_delete', params, options),
         },
         resources: {
           reissue: {
@@ -64,14 +151,14 @@ export class WorkBuddyClient {
           },
           status: {
             /**
-             * Update status (enroute, onsite, checkedout, completed, onhold).
+             * Update status (completed, onhold).
              * Operation: PublicJobStageResourceController_updateStatus
              */
             updateStatus: (params = {}, options = {}) =>
               this.request('PublicJobStageResourceController_updateStatus', params, options),
           },
           /**
-           * Get all assigned resources for a stage.
+           * List people assigned to the stage via this API: employees (resource rows) and the stage contractor when set. Contractors assigned with POST .../resources appear here with isContractor=true (same shape as the assign response) (WBS-10448). Login contacts auto-created for contractor dispatch are excluded.
            * Operation: PublicJobStageResourceController_list
            */
           list: (params = {}, options = {}) => this.request('PublicJobStageResourceController_list', params, options),
@@ -81,13 +168,13 @@ export class WorkBuddyClient {
           pages: (params = {}, options = {}) =>
             this.paginatePages('PublicJobStageResourceController_list', params, options),
           /**
-           * Assign a technician or contractor.
+           * Assign an Employee or Subcontractor by contactId. Employee → resource row. Subcontractor → stage contractor (isContractor=true). Both appear on GET list (WBS-10448). contactId is a person Contact id (use /employees for staff), not a CRM Contact from /contacts (WBS-10445 / WBS-10442).
            * Operation: PublicJobStageResourceController_assign
            */
           assign: (params = {}, options = {}) =>
             this.request('PublicJobStageResourceController_assign', params, options),
           /**
-           * Get a specific resource assignment.
+           * Get one assignment by id. Employee rows use the resource/contact id; the stage contractor uses the contractor contact id (same id as POST assign when isContractor=true) (WBS-10448).
            * Operation: PublicJobStageResourceController_get
            */
           get: (params = {}, options = {}) => this.request('PublicJobStageResourceController_get', params, options),
@@ -417,14 +504,37 @@ export class WorkBuddyClient {
       dispatch: (params = {}, options = {}) => this.request('PublicApiJobController_dispatch', params, options),
     };
 
+    this.items = {
+      /**
+       * Find a job line item by external integration ID.
+       * Operation: PublicApiJobLineItemController_list
+       */
+      list: (params = {}, options = {}) => this.request('PublicApiJobLineItemController_list', params, options),
+    };
+
+    this.pendingItems = {
+      /**
+       * Find a pending stage item by its external integration ID.
+       * Operation: PublicApiPendingItemController_list
+       */
+      list: (params = {}, options = {}) => this.request('PublicApiPendingItemController_list', params, options),
+    };
+
     this.stages = {
       complete: {
         /**
-         * Mark a stage as completed. Field work is done but stage may still need finalisation/billing.
+         * Mark a stage as completed. Field work is done but stage may still need finalisation/billing. Optional statusId selects a tenant Completed status from GET /settings/stage-statuses (systemStatus Completed); omit to use the system Completed status (MAI-2101).
          * Operation: PublicJobStageController_complete
          */
         complete: (params = {}, options = {}) => this.request('PublicJobStageController_complete', params, options),
       },
+      inProgress: {
+        /**
+         * Set the stage to an In Progress status. Pass statusId from GET /settings/stage-statuses with systemStatus In Progress (multiple peer statuses may share that systemStatus) (MAI-2101).
+         * Operation: PublicJobStageController_inProgress
+         */
+        inProgress: (params = {}, options = {}) => this.request('PublicJobStageController_inProgress', params, options),
+      },
       finalise: {
         /**
          * Finalise a completed stage. This typically indicates billing/invoicing is complete.
@@ -439,6 +549,13 @@ export class WorkBuddyClient {
          */
         cancel: (params = {}, options = {}) => this.request('PublicJobStageController_cancel', params, options),
       },
+      onHold: {
+        /**
+         * Set the stage to an On Hold status. Pass statusId from GET /settings/stage-statuses with systemStatus On Hold (multiple peer statuses may share that systemStatus). Blocked from Completed, Closed, or Finalised.
+         * Operation: PublicJobStageController_onHold
+         */
+        onHold: (params = {}, options = {}) => this.request('PublicJobStageController_onHold', params, options),
+      },
       reverse: {
         /**
          * Reverse (reopen) a stage to a previous status. This is an admin action that bypasses normal transition rules and clears fields appropriate to the target status.
@@ -464,7 +581,7 @@ export class WorkBuddyClient {
        */
       update: (params = {}, options = {}) => this.request('PublicJobStageController_update', params, options),
       /**
-       * Permanently delete a stage and all associated items/resources. This action cannot be undone.
+       * Delete a stage. If tenant settings are configured to mark stages and items as cancelled on deletion, the stage is cancelled instead of permanently removed.
        * Operation: PublicJobStageController_delete
        */
       delete: (params = {}, options = {}) => this.request('PublicJobStageController_delete', params, options),
@@ -478,7 +595,7 @@ export class WorkBuddyClient {
     this.settings = {
       entityStatuses: {
         /**
-         * Retrieve all active statuses for a given entity type. Supported entities: customer, contractor, supplier
+         * Retrieve all active statuses for a given entity type. Supported entities: customer, contractor, supplier, contact, external-user, pending-item
          * Operation: PublicApiEntityStatusController_list
          */
         list: (params = {}, options = {}) => this.request('PublicApiEntityStatusController_list', params, options),
@@ -497,6 +614,13 @@ export class WorkBuddyClient {
          */
         list: (params = {}, options = {}) => this.request('PublicApiJobTypeController_list', params, options),
       },
+      jobTemplates: {
+        /**
+         * Retrieve all active, public job templates configured for the tenant. Use the returned id as the templateId for POST /jobs/template/:templateId.
+         * Operation: PublicApiJobTemplateController_list
+         */
+        list: (params = {}, options = {}) => this.request('PublicApiJobTemplateController_list', params, options),
+      },
       priorities: {
         /**
          * Retrieve all active priority levels configured for the tenant. Priorities indicate the urgency of jobs (e.g., Critical, High, Medium, Low).
@@ -504,11 +628,38 @@ export class WorkBuddyClient {
          */
         list: (params = {}, options = {}) => this.request('PublicApiPriorityController_list', params, options),
       },
-      stageStatuses: {
+      pricebooks: {
         /**
-         * Retrieve all stage statuses configured for the tenant. Stage statuses represent the workflow states a stage (work order) can transition through (e.g., New, Dispatched, En Route, On Site, Completed, Finalised).
-         * Operation: PublicApiStageStatusController_list
+         * Discover tenant pricebooks for a category (customer / contractor / supplier). Use category=customer&status=current&assignableOnly=true for job-create candidates. Optional accountId scopes to a CRM account (includeGlobal defaults true). Each item includes company (owning company) and optional account — both match Settings UI fields.
+         * Operation: PublicApiPriceBookController_list
          */
+        list: (params = {}, options = {}) => this.request('PublicApiPriceBookController_list', params, options),
+        /**
+         * Retrieve a pricebook by id (preferred) or exact name (case-insensitive). Pass category when the name may exist in more than one category. Response includes company (owning company) and optional account, matching Settings UI.
+         * Operation: PublicApiPriceBookController_getByIdOrName
+         */
+        getByIdOrName: (params = {}, options = {}) =>
+          this.request('PublicApiPriceBookController_getByIdOrName', params, options),
+      },
+      stageStatuses: {
+        /**
+   * Retrieve all stage statuses configured for the tenant (Settings > Stage Status).
+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:
+- identity: id, name, systemName, systemStatus, sortOrder
+- description (nullable)
+- activityOptions: shareWithCustomer, shareWithField (always present; unset = false)
+- displayOptions: showInContractorPortal, showInFieldApp (always present)
+
+Display Options rules (match Settings UI):
+- Only systemStatus On Hold or In Progress support display options; other systemStatus values return both flags as false
+- showInFieldApp is not configurable for In Progress and is always false
+- When supported and not configured, visibility defaults to true (Settings UI default)
+
+Requires scope: settings:read
+   * Operation: PublicApiStageStatusController_list
+   */
         list: (params = {}, options = {}) => this.request('PublicApiStageStatusController_list', params, options),
       },
       tags: {
@@ -562,7 +713,12 @@ export class WorkBuddyClient {
          */
         create: (params = {}, options = {}) => this.request('PublicApiItemController_create', params, options),
         /**
-         * Retrieve a settings item by ID.
+         * Create or partially update a settings item using integrationId when supplied, otherwise name. Create still requires mandatory item fields.
+         * Operation: PublicApiItemController_upsert
+         */
+        upsert: (params = {}, options = {}) => this.request('PublicApiItemController_upsert', params, options),
+        /**
+         * Retrieve a settings item by ID, name, or integration ID.
          * Operation: PublicApiItemController_getById
          */
         get: (params = {}, options = {}) => this.request('PublicApiItemController_getById', params, options),
@@ -576,15 +732,10 @@ export class WorkBuddyClient {
          * Operation: PublicApiItemController_delete
          */
         delete: (params = {}, options = {}) => this.request('PublicApiItemController_delete', params, options),
-        /**
-         * Create or update a settings item using integrationId or name as the match key.
-         * Operation: PublicApiItemController_upsert
-         */
-        upsert: (params = {}, options = {}) => this.request('PublicApiItemController_upsert', params, options),
       },
       itemCategories: {
         /**
-         * Retrieve active item categories and sub-categories.
+         * Retrieve active item categories and sub-categories. Use search, name, or id to filter by category/sub-category name or id.
          * Operation: PublicApiItemCategoryController_list
          */
         list: (params = {}, options = {}) => this.request('PublicApiItemCategoryController_list', params, options),
@@ -601,6 +752,58 @@ export class WorkBuddyClient {
          */
         list: (params = {}, options = {}) => this.request('PublicApiUoMController_list', params, options),
       },
+      customFields: {
+        jobs: {
+          /**
+           * Retrieve configured custom fields that may be used in Job customFields payloads.
+           * Operation: PublicApiCustomFieldController_listJobCustomFields
+           */
+          listJobCustomFields: (params = {}, options = {}) =>
+            this.request('PublicApiCustomFieldController_listJobCustomFields', params, options),
+        },
+        stages: {
+          /**
+           * Retrieve configured custom fields that may be used in Stage customFields payloads.
+           * Operation: PublicApiCustomFieldController_listStageCustomFields
+           */
+          listStageCustomFields: (params = {}, options = {}) =>
+            this.request('PublicApiCustomFieldController_listStageCustomFields', params, options),
+        },
+        accounts: {
+          /**
+           * Retrieve configured custom fields that may be used in CRM account customFields payloads.
+           * Operation: PublicApiCustomFieldController_listAccountCustomFields
+           */
+          listAccountCustomFields: (params = {}, options = {}) =>
+            this.request('PublicApiCustomFieldController_listAccountCustomFields', params, options),
+        },
+        items: {
+          /**
+           * Retrieve configured custom fields that may be used in settings item customFields payloads.
+           * Operation: PublicApiCustomFieldController_listItemCustomFields
+           */
+          listItemCustomFields: (params = {}, options = {}) =>
+            this.request('PublicApiCustomFieldController_listItemCustomFields', params, options),
+        },
+      },
+      roles: {
+        clientPortal: {
+          /**
+           * Roles assignable to customer login contacts (UserType.Client). Includes custom client roles; includes built-in system client roles only when Enable System Security Roles is on for the tenant. Use item.id as roleId when login is true on contact create/invite.
+           * Operation: PublicApiPortalRoleController_listClientPortal
+           */
+          list: (params = {}, options = {}) =>
+            this.request('PublicApiPortalRoleController_listClientPortal', params, options),
+        },
+        contractorPortal: {
+          /**
+           * Roles assignable to contractor login contacts (UserType.Subcontractor). Includes custom contractor roles; includes built-in system contractor roles only when Enable System Security Roles is on for the tenant. Use item.id as roleId when login is true on contact create/invite.
+           * Operation: PublicApiPortalRoleController_listContractorPortal
+           */
+          list: (params = {}, options = {}) =>
+            this.request('PublicApiPortalRoleController_listContractorPortal', params, options),
+        },
+      },
     };
 
     this.attachments = {
@@ -637,9 +840,25 @@ export class WorkBuddyClient {
 
     this.crm = {
       customers: {
+        status: {
+          /**
+           * Update customer status
+           * Operation: PublicCrmCustomerController_updateStatus
+           */
+          updateStatus: (params = {}, options = {}) =>
+            this.request('PublicCrmCustomerController_updateStatus', params, options),
+        },
         contacts: {
+          invite: {
+            /**
+             * Invite contact (CRM)
+             * Operation: PublicCrmCustomerController_inviteContact
+             */
+            inviteContact: (params = {}, options = {}) =>
+              this.request('PublicCrmCustomerController_inviteContact', params, options),
+          },
           /**
-           * List contacts for customer
+           * List contacts for customer (contacts + external users)
            * Operation: PublicCrmCustomerController_listContacts
            */
           list: (params = {}, options = {}) =>
@@ -650,6 +869,18 @@ export class WorkBuddyClient {
           /** Iterate raw pages by following cursor pagination for list(). */
           pages: (params = {}, options = {}) =>
             this.paginatePages('PublicCrmCustomerController_listContacts', params, options),
+          /**
+           * Create customer contact
+           * Operation: PublicCrmCustomerController_createContact
+           */
+          createContact: (params = {}, options = {}) =>
+            this.request('PublicCrmCustomerController_createContact', params, options),
+          /**
+           * Delete customer contact
+           * Operation: PublicCrmCustomerController_deleteContact
+           */
+          deleteContact: (params = {}, options = {}) =>
+            this.request('PublicCrmCustomerController_deleteContact', params, options),
         },
         sites: {
           /**
@@ -687,6 +918,11 @@ export class WorkBuddyClient {
          * Operation: PublicCrmCustomerController_update
          */
         update: (params = {}, options = {}) => this.request('PublicCrmCustomerController_update', params, options),
+        /**
+         * Delete customer
+         * Operation: PublicCrmCustomerController_delete
+         */
+        delete: (params = {}, options = {}) => this.request('PublicCrmCustomerController_delete', params, options),
       },
       employees: {
         /**
@@ -705,6 +941,48 @@ export class WorkBuddyClient {
         get: (params = {}, options = {}) => this.request('PublicCrmEmployeeController_getById', params, options),
       },
       contractors: {
+        status: {
+          /**
+           * Update contractor status
+           * Operation: PublicCrmContractorController_updateStatus
+           */
+          updateStatus: (params = {}, options = {}) =>
+            this.request('PublicCrmContractorController_updateStatus', params, options),
+        },
+        contacts: {
+          invite: {
+            /**
+             * Invite contact (CRM > Contractors)
+             * Operation: PublicCrmContractorController_inviteContact
+             */
+            inviteContact: (params = {}, options = {}) =>
+              this.request('PublicCrmContractorController_inviteContact', params, options),
+          },
+          /**
+           * List contacts for contractor (contacts + external users)
+           * Operation: PublicCrmContractorController_listContacts
+           */
+          list: (params = {}, options = {}) =>
+            this.request('PublicCrmContractorController_listContacts', params, options),
+          /** Iterate all items by following cursor pagination for list(). */
+          all: (params = {}, options = {}) =>
+            this.paginate('PublicCrmContractorController_listContacts', params, options),
+          /** Iterate raw pages by following cursor pagination for list(). */
+          pages: (params = {}, options = {}) =>
+            this.paginatePages('PublicCrmContractorController_listContacts', params, options),
+          /**
+           * Create contractor contact
+           * Operation: PublicCrmContractorController_createContact
+           */
+          createContact: (params = {}, options = {}) =>
+            this.request('PublicCrmContractorController_createContact', params, options),
+          /**
+           * Delete contractor contact
+           * Operation: PublicCrmContractorController_deleteContact
+           */
+          deleteContact: (params = {}, options = {}) =>
+            this.request('PublicCrmContractorController_deleteContact', params, options),
+        },
         /**
          * List contractors
          * Operation: PublicCrmContractorController_list
@@ -729,8 +1007,21 @@ export class WorkBuddyClient {
          * Operation: PublicCrmContractorController_update
          */
         update: (params = {}, options = {}) => this.request('PublicCrmContractorController_update', params, options),
+        /**
+         * Delete contractor
+         * Operation: PublicCrmContractorController_delete
+         */
+        delete: (params = {}, options = {}) => this.request('PublicCrmContractorController_delete', params, options),
       },
       suppliers: {
+        status: {
+          /**
+           * Update supplier status
+           * Operation: PublicCrmSupplierController_updateStatus
+           */
+          updateStatus: (params = {}, options = {}) =>
+            this.request('PublicCrmSupplierController_updateStatus', params, options),
+        },
         /**
          * List suppliers
          * Operation: PublicCrmSupplierController_list
@@ -755,6 +1046,11 @@ export class WorkBuddyClient {
          * Operation: PublicCrmSupplierController_update
          */
         update: (params = {}, options = {}) => this.request('PublicCrmSupplierController_update', params, options),
+        /**
+         * Delete supplier
+         * Operation: PublicCrmSupplierController_delete
+         */
+        delete: (params = {}, options = {}) => this.request('PublicCrmSupplierController_delete', params, options),
       },
       companies: {
         /**
@@ -784,14 +1080,22 @@ export class WorkBuddyClient {
         pages: (params = {}, options = {}) =>
           this.paginatePages('PublicCrmExternalUserController_list', params, options),
         /**
-         * Get external user by ID
+         * Login Contact (portal user). parents lists active parent accounts only; portal role is parents[].role.
          * Operation: PublicCrmExternalUserController_getById
          */
         get: (params = {}, options = {}) => this.request('PublicCrmExternalUserController_getById', params, options),
       },
       contacts: {
+        status: {
+          /**
+           * Update contact status
+           * Operation: PublicCrmContactController_updateStatus
+           */
+          updateStatus: (params = {}, options = {}) =>
+            this.request('PublicCrmContactController_updateStatus', params, options),
+        },
         /**
-         * List contacts (Basic and Login contacts)
+         * List contacts (contacts + external users)
          * Operation: PublicCrmContactController_list
          */
         list: (params = {}, options = {}) => this.request('PublicCrmContactController_list', params, options),
@@ -800,10 +1104,15 @@ export class WorkBuddyClient {
         /** Iterate raw pages by following cursor pagination for list(). */
         pages: (params = {}, options = {}) => this.paginatePages('PublicCrmContactController_list', params, options),
         /**
-         * Get contact by ID
+         * Returns a people contact (basic or Login Contact). parents lists active parent accounts only (inactive/soft-deleted omitted); portal role for Login Contacts is parents[].role.
          * Operation: PublicCrmContactController_getById
          */
         get: (params = {}, options = {}) => this.request('PublicCrmContactController_getById', params, options),
+        /**
+         * Update contact
+         * Operation: PublicCrmContactController_update
+         */
+        update: (params = {}, options = {}) => this.request('PublicCrmContactController_update', params, options),
       },
       invites: {
         /**
@@ -822,8 +1131,20 @@ export class WorkBuddyClient {
         get: (params = {}, options = {}) => this.request('PublicCrmInviteController_getById', params, options),
       },
       sites: {
+        contacts: {
+          /**
+           * List contacts linked to this site (same pattern as GET /customers/{id}/contacts). Returns basic contacts and external users parented to the site.
+           * Operation: PublicCrmSiteController_listContacts
+           */
+          list: (params = {}, options = {}) => this.request('PublicCrmSiteController_listContacts', params, options),
+          /** Iterate all items by following cursor pagination for list(). */
+          all: (params = {}, options = {}) => this.paginate('PublicCrmSiteController_listContacts', params, options),
+          /** Iterate raw pages by following cursor pagination for list(). */
+          pages: (params = {}, options = {}) =>
+            this.paginatePages('PublicCrmSiteController_listContacts', params, options),
+        },
         /**
-         * List all sites
+         * List CRM sites for the tenant (Managed and Account only — Adhoc sites are excluded). Each item includes type (Managed | Account), optional primaryContact, and address. Optional search filters by site name/address tokens (space-separated words; all must match).
          * Operation: PublicCrmSiteController_list
          */
         list: (params = {}, options = {}) => this.request('PublicCrmSiteController_list', params, options),
@@ -832,7 +1153,7 @@ export class WorkBuddyClient {
         /** Iterate raw pages by following cursor pagination for list(). */
         pages: (params = {}, options = {}) => this.paginatePages('PublicCrmSiteController_list', params, options),
         /**
-         * Get site by ID
+         * Retrieve a CRM site by id (Managed or Account only). Adhoc sites are not exposed. Includes primaryContact when set (UI Primary Contact). type is CRM Site Type — not address.type.
          * Operation: PublicCrmSiteController_getById
          */
         get: (params = {}, options = {}) => this.request('PublicCrmSiteController_getById', params, options),
@@ -1236,6 +1557,31 @@ export const operations = [
     queryParams: [],
     hasRequestBody: true,
   },
+  {
+    operationId: 'PublicApiJobController_createFromTemplate',
+    resourcePath: ['jobs', 'template'],
+    actionName: 'createFromTemplate',
+    displayName: 'Create a new job from template',
+    description:
+      'Create a job using a job template. Template-owned fields win over request values before final job validation.',
+    method: 'POST',
+    path: '/jobs/template/{templateId}',
+    pathParams: ['templateId'],
+    queryParams: [],
+    hasRequestBody: true,
+  },
+  {
+    operationId: 'PublicApiJobController_updateStatus',
+    resourcePath: ['jobs', 'status'],
+    actionName: 'updateStatus',
+    displayName: 'Update job status',
+    description: 'Change an existing job status and cascade the change to stages through the job domain command.',
+    method: 'PATCH',
+    path: '/jobs/{id}/status',
+    pathParams: ['id'],
+    queryParams: [],
+    hasRequestBody: true,
+  },
   {
     operationId: 'PublicApiJobController_update',
     resourcePath: ['jobs'],
@@ -1300,6 +1646,18 @@ export const operations = [
     queryParams: ['cursor', 'limit'],
     hasRequestBody: false,
   },
+  {
+    operationId: 'PublicApiJobController_createStageItems',
+    resourcePath: ['jobs', 'stages', 'items'],
+    actionName: 'createStageItems',
+    displayName: 'Create stage items',
+    description: 'Add one or more catalogue-backed line items to a stage.',
+    method: 'POST',
+    path: '/jobs/{id}/stages/{stageId}/items',
+    pathParams: ['id', 'stageId'],
+    queryParams: [],
+    hasRequestBody: true,
+  },
   {
     operationId: 'PublicApiJobController_getStageItem',
     resourcePath: ['jobs', 'stages', 'items'],
@@ -1312,6 +1670,140 @@ export const operations = [
     queryParams: [],
     hasRequestBody: false,
   },
+  {
+    operationId: 'PublicApiJobController_updateStageItem',
+    resourcePath: ['jobs', 'stages', 'items'],
+    actionName: 'updateStageItem',
+    displayName: 'Update stage item',
+    description: 'Update mutable fields on a stage line item.',
+    method: 'PATCH',
+    path: '/jobs/{id}/stages/{stageId}/items/{itemId}',
+    pathParams: ['id', 'stageId', 'itemId'],
+    queryParams: [],
+    hasRequestBody: true,
+  },
+  {
+    operationId: 'PublicApiJobController_deleteStageItem',
+    resourcePath: ['jobs', 'stages', 'items'],
+    actionName: 'deleteStageItem',
+    displayName: 'Delete stage item',
+    description: 'Remove or cancel a stage item depending on tenant deletion settings.',
+    method: 'DELETE',
+    path: '/jobs/{id}/stages/{stageId}/items/{itemId}',
+    pathParams: ['id', 'stageId', 'itemId'],
+    queryParams: [],
+    hasRequestBody: false,
+  },
+  {
+    operationId: 'PublicApiJobLineItemController_list',
+    resourcePath: ['items'],
+    actionName: 'list',
+    displayName: 'Find job line items',
+    description: 'Find a job line item by external integration ID.',
+    method: 'GET',
+    path: '/items',
+    pathParams: [],
+    queryParams: ['integrationId'],
+    hasRequestBody: false,
+  },
+  {
+    operationId: 'PublicApiPendingItemController_list',
+    resourcePath: ['pendingItems'],
+    actionName: 'list',
+    displayName: 'Find a pending item',
+    description: 'Find a pending stage item by its external integration ID.',
+    method: 'GET',
+    path: '/pending-items',
+    pathParams: [],
+    queryParams: ['integrationId'],
+    hasRequestBody: false,
+  },
+  {
+    operationId: 'PublicJobStagePendingItemController_list',
+    resourcePath: ['jobs', 'stages', 'pendingItems'],
+    actionName: 'list',
+    paginatedItemsActionName: 'all',
+    paginatedPagesActionName: 'pages',
+    displayName: 'List stage pending items',
+    description: 'List items awaiting approval for a stage.',
+    method: 'GET',
+    path: '/jobs/{id}/stages/{stageId}/pending-items',
+    pathParams: ['id', 'stageId'],
+    queryParams: ['cursor', 'limit'],
+    hasRequestBody: false,
+  },
+  {
+    operationId: 'PublicJobStagePendingItemController_create',
+    resourcePath: ['jobs', 'stages', 'pendingItems'],
+    actionName: 'create',
+    displayName: 'Create stage pending items',
+    description: 'Create one or more items awaiting approval.',
+    method: 'POST',
+    path: '/jobs/{id}/stages/{stageId}/pending-items',
+    pathParams: ['id', 'stageId'],
+    queryParams: [],
+    hasRequestBody: true,
+  },
+  {
+    operationId: 'PublicJobStagePendingItemController_get',
+    resourcePath: ['jobs', 'stages', 'pendingItems'],
+    actionName: 'get',
+    displayName: 'Get stage pending item',
+    description: 'Get a specific pending item within a stage.',
+    method: 'GET',
+    path: '/jobs/{id}/stages/{stageId}/pending-items/{itemId}',
+    pathParams: ['id', 'stageId', 'itemId'],
+    queryParams: [],
+    hasRequestBody: false,
+  },
+  {
+    operationId: 'PublicJobStagePendingItemController_update',
+    resourcePath: ['jobs', 'stages', 'pendingItems'],
+    actionName: 'update',
+    displayName: 'Update stage pending item',
+    description: 'Update general pending-item fields. Use the status route for itemStatus.',
+    method: 'PATCH',
+    path: '/jobs/{id}/stages/{stageId}/pending-items/{itemId}',
+    pathParams: ['id', 'stageId', 'itemId'],
+    queryParams: [],
+    hasRequestBody: true,
+  },
+  {
+    operationId: 'PublicJobStagePendingItemController_delete',
+    resourcePath: ['jobs', 'stages', 'pendingItems'],
+    actionName: 'delete',
+    displayName: 'Delete stage pending item',
+    description: 'Delete or decline a pending item according to tenant deletion settings.',
+    method: 'DELETE',
+    path: '/jobs/{id}/stages/{stageId}/pending-items/{itemId}',
+    pathParams: ['id', 'stageId', 'itemId'],
+    queryParams: [],
+    hasRequestBody: false,
+  },
+  {
+    operationId: 'PublicJobStagePendingItemController_updateStatus',
+    resourcePath: ['jobs', 'stages', 'pendingItems', 'status'],
+    actionName: 'updateStatus',
+    displayName: 'Update pending-item status',
+    description: 'Set the dedicated pending-item status. No general item fields are accepted.',
+    method: 'PATCH',
+    path: '/jobs/{id}/stages/{stageId}/pending-items/{itemId}/status',
+    pathParams: ['id', 'stageId', 'itemId'],
+    queryParams: [],
+    hasRequestBody: true,
+  },
+  {
+    operationId: 'PublicJobStagePendingItemController_approve',
+    resourcePath: ['jobs', 'stages', 'pendingItems', 'approve'],
+    actionName: 'approve',
+    displayName: 'Approve stage pending item',
+    description: 'Approve a pending item and promote it to a standard stage item.',
+    method: 'POST',
+    path: '/jobs/{id}/stages/{stageId}/pending-items/{itemId}/approve',
+    pathParams: ['id', 'stageId', 'itemId'],
+    queryParams: [],
+    hasRequestBody: false,
+  },
   {
     operationId: 'PublicJobStageController_create',
     resourcePath: ['stages'],
@@ -1341,7 +1833,8 @@ export const operations = [
     resourcePath: ['stages'],
     actionName: 'delete',
     displayName: 'Delete a stage',
-    description: 'Permanently delete a stage and all associated items/resources. This action cannot be undone.',
+    description:
+      'Delete a stage. If tenant settings are configured to mark stages and items as cancelled on deletion, the stage is cancelled instead of permanently removed.',
     method: 'DELETE',
     path: '/stages/{id}',
     pathParams: ['id'],
@@ -1365,13 +1858,27 @@ export const operations = [
     resourcePath: ['stages', 'complete'],
     actionName: 'complete',
     displayName: 'Complete a stage',
-    description: 'Mark a stage as completed. Field work is done but stage may still need finalisation/billing.',
+    description:
+      'Mark a stage as completed. Field work is done but stage may still need finalisation/billing. Optional statusId selects a tenant Completed status from GET /settings/stage-statuses (systemStatus Completed); omit to use the system Completed status (MAI-2101).',
     method: 'POST',
     path: '/stages/{id}/complete',
     pathParams: ['id'],
     queryParams: [],
     hasRequestBody: true,
   },
+  {
+    operationId: 'PublicJobStageController_inProgress',
+    resourcePath: ['stages', 'inProgress'],
+    actionName: 'inProgress',
+    displayName: 'Mark a stage in progress',
+    description:
+      'Set the stage to an In Progress status. Pass statusId from GET /settings/stage-statuses with systemStatus In Progress (multiple peer statuses may share that systemStatus) (MAI-2101).',
+    method: 'POST',
+    path: '/stages/{id}/in-progress',
+    pathParams: ['id'],
+    queryParams: [],
+    hasRequestBody: true,
+  },
   {
     operationId: 'PublicJobStageController_finalise',
     resourcePath: ['stages', 'finalise'],
@@ -1396,6 +1903,19 @@ export const operations = [
     queryParams: [],
     hasRequestBody: true,
   },
+  {
+    operationId: 'PublicJobStageController_onHold',
+    resourcePath: ['stages', 'onHold'],
+    actionName: 'onHold',
+    displayName: 'Put a stage on hold',
+    description:
+      'Set the stage to an On Hold status. Pass statusId from GET /settings/stage-statuses with systemStatus On Hold (multiple peer statuses may share that systemStatus). Blocked from Completed, Closed, or Finalised.',
+    method: 'POST',
+    path: '/stages/{id}/on-hold',
+    pathParams: ['id'],
+    queryParams: [],
+    hasRequestBody: true,
+  },
   {
     operationId: 'PublicJobStageController_reverse',
     resourcePath: ['stages', 'reverse'],
@@ -1428,7 +1948,8 @@ export const operations = [
     paginatedItemsActionName: 'all',
     paginatedPagesActionName: 'pages',
     displayName: 'List stage resources',
-    description: 'Get all assigned resources for a stage.',
+    description:
+      'List people assigned to the stage via this API: employees (resource rows) and the stage contractor when set. Contractors assigned with POST .../resources appear here with isContractor=true (same shape as the assign response) (WBS-10448). Login contacts auto-created for contractor dispatch are excluded.',
     method: 'GET',
     path: '/jobs/{jobId}/stages/{stageId}/resources',
     pathParams: ['jobId', 'stageId'],
@@ -1440,7 +1961,8 @@ export const operations = [
     resourcePath: ['jobs', 'stages', 'resources'],
     actionName: 'assign',
     displayName: 'Assign resource to stage',
-    description: 'Assign a technician or contractor.',
+    description:
+      'Assign an Employee or Subcontractor by contactId. Employee → resource row. Subcontractor → stage contractor (isContractor=true). Both appear on GET list (WBS-10448). contactId is a person Contact id (use /employees for staff), not a CRM Contact from /contacts (WBS-10445 / WBS-10442).',
     method: 'POST',
     path: '/jobs/{jobId}/stages/{stageId}/resources',
     pathParams: ['jobId', 'stageId'],
@@ -1452,7 +1974,8 @@ export const operations = [
     resourcePath: ['jobs', 'stages', 'resources'],
     actionName: 'get',
     displayName: 'Get stage resource',
-    description: 'Get a specific resource assignment.',
+    description:
+      'Get one assignment by id. Employee rows use the resource/contact id; the stage contractor uses the contractor contact id (same id as POST assign when isContractor=true) (WBS-10448).',
     method: 'GET',
     path: '/jobs/{jobId}/stages/{stageId}/resources/{resourceId}',
     pathParams: ['jobId', 'stageId', 'resourceId'],
@@ -1488,7 +2011,7 @@ export const operations = [
     resourcePath: ['jobs', 'stages', 'resources', 'status'],
     actionName: 'updateStatus',
     displayName: 'Update resource status',
-    description: 'Update status (enroute, onsite, checkedout, completed, onhold).',
+    description: 'Update status (completed, onhold).',
     method: 'POST',
     path: '/jobs/{jobId}/stages/{stageId}/resources/{resourceId}/status',
     pathParams: ['jobId', 'stageId', 'resourceId'],
@@ -1501,7 +2024,7 @@ export const operations = [
     actionName: 'list',
     displayName: 'List entity statuses',
     description:
-      'Retrieve all active statuses for a given entity type. Supported entities: customer, contractor, supplier',
+      'Retrieve all active statuses for a given entity type. Supported entities: customer, contractor, supplier, contact, external-user, pending-item',
     method: 'GET',
     path: '/settings/entity-statuses/{entity}',
     pathParams: ['entity'],
@@ -1534,6 +2057,19 @@ export const operations = [
     queryParams: [],
     hasRequestBody: false,
   },
+  {
+    operationId: 'PublicApiJobTemplateController_list',
+    resourcePath: ['settings', 'jobTemplates'],
+    actionName: 'list',
+    displayName: 'List job templates',
+    description:
+      'Retrieve all active, public job templates configured for the tenant. Use the returned id as the templateId for POST /jobs/template/:templateId.',
+    method: 'GET',
+    path: '/settings/job-templates',
+    pathParams: [],
+    queryParams: [],
+    hasRequestBody: false,
+  },
   {
     operationId: 'PublicApiPriorityController_list',
     resourcePath: ['settings', 'priorities'],
@@ -1547,13 +2083,39 @@ export const operations = [
     queryParams: [],
     hasRequestBody: false,
   },
+  {
+    operationId: 'PublicApiPriceBookController_list',
+    resourcePath: ['settings', 'pricebooks'],
+    actionName: 'list',
+    displayName: 'List pricebooks',
+    description:
+      'Discover tenant pricebooks for a category (customer / contractor / supplier). Use category=customer&status=current&assignableOnly=true for job-create candidates. Optional accountId scopes to a CRM account (includeGlobal defaults true). Each item includes company (owning company) and optional account — both match Settings UI fields.',
+    method: 'GET',
+    path: '/settings/pricebooks',
+    pathParams: [],
+    queryParams: ['limit', 'assignableOnly', 'mode', 'search', 'includeGlobal', 'accountId', 'status', 'category'],
+    hasRequestBody: false,
+  },
+  {
+    operationId: 'PublicApiPriceBookController_getByIdOrName',
+    resourcePath: ['settings', 'pricebooks'],
+    actionName: 'getByIdOrName',
+    displayName: 'Get pricebook',
+    description:
+      'Retrieve a pricebook by id (preferred) or exact name (case-insensitive). Pass category when the name may exist in more than one category. Response includes company (owning company) and optional account, matching Settings UI.',
+    method: 'GET',
+    path: '/settings/pricebooks/{idOrName}',
+    pathParams: ['idOrName'],
+    queryParams: ['category'],
+    hasRequestBody: false,
+  },
   {
     operationId: 'PublicApiStageStatusController_list',
     resourcePath: ['settings', 'stageStatuses'],
     actionName: 'list',
     displayName: 'List stage statuses',
     description:
-      'Retrieve all stage statuses configured for the tenant. Stage statuses represent the workflow states a stage (work order) can transition through (e.g., New, Dispatched, En Route, On Site, Completed, Finalised).',
+      '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',
     method: 'GET',
     path: '/settings/stage-statuses',
     pathParams: [],
@@ -1647,12 +2209,25 @@ export const operations = [
     queryParams: [],
     hasRequestBody: true,
   },
+  {
+    operationId: 'PublicApiItemController_upsert',
+    resourcePath: ['settings', 'items'],
+    actionName: 'upsert',
+    displayName: 'Upsert item',
+    description:
+      'Create or partially update a settings item using integrationId when supplied, otherwise name. Create still requires mandatory item fields.',
+    method: 'PUT',
+    path: '/settings/items',
+    pathParams: [],
+    queryParams: [],
+    hasRequestBody: true,
+  },
   {
     operationId: 'PublicApiItemController_getById',
     resourcePath: ['settings', 'items'],
     actionName: 'get',
     displayName: 'Get item',
-    description: 'Retrieve a settings item by ID.',
+    description: 'Retrieve a settings item by ID, name, or integration ID.',
     method: 'GET',
     path: '/settings/items/{id}',
     pathParams: ['id'],
@@ -1683,28 +2258,17 @@ export const operations = [
     queryParams: [],
     hasRequestBody: false,
   },
-  {
-    operationId: 'PublicApiItemController_upsert',
-    resourcePath: ['settings', 'items'],
-    actionName: 'upsert',
-    displayName: 'Upsert item',
-    description: 'Create or update a settings item using integrationId or name as the match key.',
-    method: 'POST',
-    path: '/settings/items/upsert',
-    pathParams: [],
-    queryParams: [],
-    hasRequestBody: true,
-  },
   {
     operationId: 'PublicApiItemCategoryController_list',
     resourcePath: ['settings', 'itemCategories'],
     actionName: 'list',
     displayName: 'List item categories',
-    description: 'Retrieve active item categories and sub-categories.',
+    description:
+      'Retrieve active item categories and sub-categories. Use search, name, or id to filter by category/sub-category name or id.',
     method: 'GET',
     path: '/settings/item-categories',
     pathParams: [],
-    queryParams: [],
+    queryParams: ['id', 'name', 'search'],
     hasRequestBody: false,
   },
   {
@@ -1731,6 +2295,80 @@ export const operations = [
     queryParams: [],
     hasRequestBody: false,
   },
+  {
+    operationId: 'PublicApiCustomFieldController_listJobCustomFields',
+    resourcePath: ['settings', 'customFields', 'jobs'],
+    actionName: 'listJobCustomFields',
+    displayName: 'List job custom fields',
+    description: 'Retrieve configured custom fields that may be used in Job customFields payloads.',
+    method: 'GET',
+    path: '/settings/custom-fields/jobs',
+    pathParams: [],
+    queryParams: [],
+    hasRequestBody: false,
+  },
+  {
+    operationId: 'PublicApiCustomFieldController_listStageCustomFields',
+    resourcePath: ['settings', 'customFields', 'stages'],
+    actionName: 'listStageCustomFields',
+    displayName: 'List stage custom fields',
+    description: 'Retrieve configured custom fields that may be used in Stage customFields payloads.',
+    method: 'GET',
+    path: '/settings/custom-fields/stages',
+    pathParams: [],
+    queryParams: [],
+    hasRequestBody: false,
+  },
+  {
+    operationId: 'PublicApiCustomFieldController_listAccountCustomFields',
+    resourcePath: ['settings', 'customFields', 'accounts'],
+    actionName: 'listAccountCustomFields',
+    displayName: 'List account custom fields',
+    description: 'Retrieve configured custom fields that may be used in CRM account customFields payloads.',
+    method: 'GET',
+    path: '/settings/custom-fields/accounts',
+    pathParams: [],
+    queryParams: [],
+    hasRequestBody: false,
+  },
+  {
+    operationId: 'PublicApiCustomFieldController_listItemCustomFields',
+    resourcePath: ['settings', 'customFields', 'items'],
+    actionName: 'listItemCustomFields',
+    displayName: 'List item custom fields',
+    description: 'Retrieve configured custom fields that may be used in settings item customFields payloads.',
+    method: 'GET',
+    path: '/settings/custom-fields/items',
+    pathParams: [],
+    queryParams: [],
+    hasRequestBody: false,
+  },
+  {
+    operationId: 'PublicApiPortalRoleController_listClientPortal',
+    resourcePath: ['settings', 'roles', 'clientPortal'],
+    actionName: 'list',
+    displayName: 'List client portal roles',
+    description:
+      'Roles assignable to customer login contacts (UserType.Client). Includes custom client roles; includes built-in system client roles only when Enable System Security Roles is on for the tenant. Use item.id as roleId when login is true on contact create/invite.',
+    method: 'GET',
+    path: '/settings/roles/client-portal',
+    pathParams: [],
+    queryParams: [],
+    hasRequestBody: false,
+  },
+  {
+    operationId: 'PublicApiPortalRoleController_listContractorPortal',
+    resourcePath: ['settings', 'roles', 'contractorPortal'],
+    actionName: 'list',
+    displayName: 'List contractor portal roles',
+    description:
+      'Roles assignable to contractor login contacts (UserType.Subcontractor). Includes custom contractor roles; includes built-in system contractor roles only when Enable System Security Roles is on for the tenant. Use item.id as roleId when login is true on contact create/invite.',
+    method: 'GET',
+    path: '/settings/roles/contractor-portal',
+    pathParams: [],
+    queryParams: [],
+    hasRequestBody: false,
+  },
   {
     operationId: 'PublicAttachmentController_createUploadSession',
     resourcePath: ['attachments'],
@@ -2272,7 +2910,7 @@ export const operations = [
     method: 'GET',
     path: '/customers',
     pathParams: [],
-    queryParams: ['status', 'cursor', 'limit'],
+    queryParams: ['search', 'integrationId', 'status', 'cursor', 'limit'],
     hasRequestBody: false,
   },
   {
@@ -2311,20 +2949,80 @@ export const operations = [
     queryParams: [],
     hasRequestBody: true,
   },
+  {
+    operationId: 'PublicCrmCustomerController_delete',
+    resourcePath: ['crm', 'customers'],
+    actionName: 'delete',
+    displayName: 'Delete customer',
+    description: 'Delete customer',
+    method: 'DELETE',
+    path: '/customers/{id}',
+    pathParams: ['id'],
+    queryParams: [],
+    hasRequestBody: false,
+  },
+  {
+    operationId: 'PublicCrmCustomerController_updateStatus',
+    resourcePath: ['crm', 'customers', 'status'],
+    actionName: 'updateStatus',
+    displayName: 'Update customer status',
+    description: 'Update customer status',
+    method: 'PATCH',
+    path: '/customers/{id}/status',
+    pathParams: ['id'],
+    queryParams: [],
+    hasRequestBody: true,
+  },
   {
     operationId: 'PublicCrmCustomerController_listContacts',
     resourcePath: ['crm', 'customers', 'contacts'],
     actionName: 'list',
     paginatedItemsActionName: 'all',
     paginatedPagesActionName: 'pages',
-    displayName: 'List contacts for customer',
-    description: 'List contacts for customer',
+    displayName: 'List contacts for customer (contacts + external users)',
+    description: 'List contacts for customer (contacts + external users)',
     method: 'GET',
     path: '/customers/{customerId}/contacts',
     pathParams: ['customerId'],
     queryParams: ['cursor', 'limit'],
     hasRequestBody: false,
   },
+  {
+    operationId: 'PublicCrmCustomerController_createContact',
+    resourcePath: ['crm', 'customers', 'contacts'],
+    actionName: 'createContact',
+    displayName: 'Create customer contact',
+    description: 'Create customer contact',
+    method: 'POST',
+    path: '/customers/{customerId}/contacts',
+    pathParams: ['customerId'],
+    queryParams: [],
+    hasRequestBody: true,
+  },
+  {
+    operationId: 'PublicCrmCustomerController_deleteContact',
+    resourcePath: ['crm', 'customers', 'contacts'],
+    actionName: 'deleteContact',
+    displayName: 'Delete customer contact',
+    description: 'Delete customer contact',
+    method: 'DELETE',
+    path: '/customers/{customerId}/contacts/{contactId}',
+    pathParams: ['customerId', 'contactId'],
+    queryParams: [],
+    hasRequestBody: false,
+  },
+  {
+    operationId: 'PublicCrmCustomerController_inviteContact',
+    resourcePath: ['crm', 'customers', 'contacts', 'invite'],
+    actionName: 'inviteContact',
+    displayName: 'Invite contact (CRM)',
+    description: 'Invite contact (CRM)',
+    method: 'POST',
+    path: '/customers/{customerId}/contacts/{contactId}/invite',
+    pathParams: ['customerId', 'contactId'],
+    queryParams: [],
+    hasRequestBody: true,
+  },
   {
     operationId: 'PublicCrmCustomerController_listSites',
     resourcePath: ['crm', 'customers', 'sites'],
@@ -2376,7 +3074,7 @@ export const operations = [
     method: 'GET',
     path: '/contractors',
     pathParams: [],
-    queryParams: ['cursor', 'limit'],
+    queryParams: ['search', 'cursor', 'limit'],
     hasRequestBody: false,
   },
   {
@@ -2415,6 +3113,80 @@ export const operations = [
     queryParams: [],
     hasRequestBody: true,
   },
+  {
+    operationId: 'PublicCrmContractorController_delete',
+    resourcePath: ['crm', 'contractors'],
+    actionName: 'delete',
+    displayName: 'Delete contractor',
+    description: 'Delete contractor',
+    method: 'DELETE',
+    path: '/contractors/{id}',
+    pathParams: ['id'],
+    queryParams: [],
+    hasRequestBody: false,
+  },
+  {
+    operationId: 'PublicCrmContractorController_updateStatus',
+    resourcePath: ['crm', 'contractors', 'status'],
+    actionName: 'updateStatus',
+    displayName: 'Update contractor status',
+    description: 'Update contractor status',
+    method: 'PATCH',
+    path: '/contractors/{id}/status',
+    pathParams: ['id'],
+    queryParams: [],
+    hasRequestBody: true,
+  },
+  {
+    operationId: 'PublicCrmContractorController_listContacts',
+    resourcePath: ['crm', 'contractors', 'contacts'],
+    actionName: 'list',
+    paginatedItemsActionName: 'all',
+    paginatedPagesActionName: 'pages',
+    displayName: 'List contacts for contractor (contacts + external users)',
+    description: 'List contacts for contractor (contacts + external users)',
+    method: 'GET',
+    path: '/contractors/{contractorId}/contacts',
+    pathParams: ['contractorId'],
+    queryParams: ['cursor', 'limit'],
+    hasRequestBody: false,
+  },
+  {
+    operationId: 'PublicCrmContractorController_createContact',
+    resourcePath: ['crm', 'contractors', 'contacts'],
+    actionName: 'createContact',
+    displayName: 'Create contractor contact',
+    description: 'Create contractor contact',
+    method: 'POST',
+    path: '/contractors/{contractorId}/contacts',
+    pathParams: ['contractorId'],
+    queryParams: [],
+    hasRequestBody: true,
+  },
+  {
+    operationId: 'PublicCrmContractorController_deleteContact',
+    resourcePath: ['crm', 'contractors', 'contacts'],
+    actionName: 'deleteContact',
+    displayName: 'Delete contractor contact',
+    description: 'Delete contractor contact',
+    method: 'DELETE',
+    path: '/contractors/{contractorId}/contacts/{contactId}',
+    pathParams: ['contractorId', 'contactId'],
+    queryParams: [],
+    hasRequestBody: false,
+  },
+  {
+    operationId: 'PublicCrmContractorController_inviteContact',
+    resourcePath: ['crm', 'contractors', 'contacts', 'invite'],
+    actionName: 'inviteContact',
+    displayName: 'Invite contact (CRM > Contractors)',
+    description: 'Invite contact (CRM > Contractors)',
+    method: 'POST',
+    path: '/contractors/{contractorId}/contacts/{contactId}/invite',
+    pathParams: ['contractorId', 'contactId'],
+    queryParams: [],
+    hasRequestBody: true,
+  },
   {
     operationId: 'PublicCrmSupplierController_list',
     resourcePath: ['crm', 'suppliers'],
@@ -2426,7 +3198,7 @@ export const operations = [
     method: 'GET',
     path: '/suppliers',
     pathParams: [],
-    queryParams: ['cursor', 'limit'],
+    queryParams: ['search', 'cursor', 'limit'],
     hasRequestBody: false,
   },
   {
@@ -2465,6 +3237,30 @@ export const operations = [
     queryParams: [],
     hasRequestBody: true,
   },
+  {
+    operationId: 'PublicCrmSupplierController_delete',
+    resourcePath: ['crm', 'suppliers'],
+    actionName: 'delete',
+    displayName: 'Delete supplier',
+    description: 'Delete supplier',
+    method: 'DELETE',
+    path: '/suppliers/{id}',
+    pathParams: ['id'],
+    queryParams: [],
+    hasRequestBody: false,
+  },
+  {
+    operationId: 'PublicCrmSupplierController_updateStatus',
+    resourcePath: ['crm', 'suppliers', 'status'],
+    actionName: 'updateStatus',
+    displayName: 'Update supplier status',
+    description: 'Update supplier status',
+    method: 'PATCH',
+    path: '/suppliers/{id}/status',
+    pathParams: ['id'],
+    queryParams: [],
+    hasRequestBody: true,
+  },
   {
     operationId: 'PublicCrmCompanyController_list',
     resourcePath: ['crm', 'companies'],
@@ -2476,7 +3272,7 @@ export const operations = [
     method: 'GET',
     path: '/companies',
     pathParams: [],
-    queryParams: ['cursor', 'limit'],
+    queryParams: ['search', 'cursor', 'limit'],
     hasRequestBody: false,
   },
   {
@@ -2510,7 +3306,8 @@ export const operations = [
     resourcePath: ['crm', 'externalUsers'],
     actionName: 'get',
     displayName: 'Get external user by ID',
-    description: 'Get external user by ID',
+    description:
+      'Login Contact (portal user). parents lists active parent accounts only; portal role is parents[].role.',
     method: 'GET',
     path: '/external-users/{id}',
     pathParams: ['id'],
@@ -2523,8 +3320,8 @@ export const operations = [
     actionName: 'list',
     paginatedItemsActionName: 'all',
     paginatedPagesActionName: 'pages',
-    displayName: 'List contacts (Basic and Login contacts)',
-    description: 'List contacts (Basic and Login contacts)',
+    displayName: 'List contacts (contacts + external users)',
+    description: 'List contacts (contacts + external users)',
     method: 'GET',
     path: '/contacts',
     pathParams: [],
@@ -2536,13 +3333,38 @@ export const operations = [
     resourcePath: ['crm', 'contacts'],
     actionName: 'get',
     displayName: 'Get contact by ID',
-    description: 'Get contact by ID',
+    description:
+      'Returns a people contact (basic or Login Contact). parents lists active parent accounts only (inactive/soft-deleted omitted); portal role for Login Contacts is parents[].role.',
     method: 'GET',
     path: '/contacts/{id}',
     pathParams: ['id'],
     queryParams: [],
     hasRequestBody: false,
   },
+  {
+    operationId: 'PublicCrmContactController_update',
+    resourcePath: ['crm', 'contacts'],
+    actionName: 'update',
+    displayName: 'Update contact',
+    description: 'Update contact',
+    method: 'PATCH',
+    path: '/contacts/{id}',
+    pathParams: ['id'],
+    queryParams: [],
+    hasRequestBody: true,
+  },
+  {
+    operationId: 'PublicCrmContactController_updateStatus',
+    resourcePath: ['crm', 'contacts', 'status'],
+    actionName: 'updateStatus',
+    displayName: 'Update contact status',
+    description: 'Update contact status',
+    method: 'PATCH',
+    path: '/contacts/{id}/status',
+    pathParams: ['id'],
+    queryParams: [],
+    hasRequestBody: true,
+  },
   {
     operationId: 'PublicCrmInviteController_list',
     resourcePath: ['crm', 'invites'],
@@ -2554,7 +3376,7 @@ export const operations = [
     method: 'GET',
     path: '/invites',
     pathParams: [],
-    queryParams: ['cursor', 'limit'],
+    queryParams: ['search', 'cursor', 'limit'],
     hasRequestBody: false,
   },
   {
@@ -2576,11 +3398,12 @@ export const operations = [
     paginatedItemsActionName: 'all',
     paginatedPagesActionName: 'pages',
     displayName: 'List all sites',
-    description: 'List all sites',
+    description:
+      'List CRM sites for the tenant (Managed and Account only — Adhoc sites are excluded). Each item includes type (Managed | Account), optional primaryContact, and address. Optional search filters by site name/address tokens (space-separated words; all must match).',
     method: 'GET',
     path: '/sites',
     pathParams: [],
-    queryParams: ['status', 'cursor', 'limit'],
+    queryParams: ['search', 'status', 'cursor', 'limit'],
     hasRequestBody: false,
   },
   {
@@ -2588,13 +3411,29 @@ export const operations = [
     resourcePath: ['crm', 'sites'],
     actionName: 'get',
     displayName: 'Get site by ID',
-    description: 'Get site by ID',
+    description:
+      'Retrieve a CRM site by id (Managed or Account only). Adhoc sites are not exposed. Includes primaryContact when set (UI Primary Contact). type is CRM Site Type — not address.type.',
     method: 'GET',
     path: '/sites/{id}',
     pathParams: ['id'],
     queryParams: [],
     hasRequestBody: false,
   },
+  {
+    operationId: 'PublicCrmSiteController_listContacts',
+    resourcePath: ['crm', 'sites', 'contacts'],
+    actionName: 'list',
+    paginatedItemsActionName: 'all',
+    paginatedPagesActionName: 'pages',
+    displayName: 'List contacts for site',
+    description:
+      'List contacts linked to this site (same pattern as GET /customers/{id}/contacts). Returns basic contacts and external users parented to the site.',
+    method: 'GET',
+    path: '/sites/{id}/contacts',
+    pathParams: ['id'],
+    queryParams: ['cursor', 'limit'],
+    hasRequestBody: false,
+  },
   {
     operationId: 'PublicApiWebhookV2Controller_listEntities',
     resourcePath: ['webhooks', 'entities'],