diff --git a/xero_accounting.yaml b/xero_accounting.yaml
index 158806bfc..92fba2da6 100644
--- a/xero_accounting.yaml
+++ b/xero_accounting.yaml
@@ -6535,6 +6535,7 @@ paths:
     parameters:
       - $ref: '#/components/parameters/requiredHeader'
     get:
+      deprecated: true
       security:
         - OAuth2:
             - accounting.settings
@@ -6543,6 +6544,7 @@ paths:
         - Accounting
       operationId: getEmployees
       summary: Retrieves employees used in Xero payrun
+      description: This endpoint is deprecated and will be removed April 28, 2026
       parameters:
         - $ref: '#/components/parameters/ifModifiedSince'
         - in: query
@@ -6599,6 +6601,7 @@ paths:
                       Description: Go to external link
                     UpdatedDateUTC: /Date(1552324737990+0000)/
     put:
+      deprecated: true
       security:
         - OAuth2:
             - accounting.settings
@@ -6606,6 +6609,7 @@ paths:
         - Accounting
       operationId: createEmployees
       summary: Creates new employees used in Xero payrun
+      description: This endpoint is deprecated and will be removed April 28, 2026
       x-hasAccountingValidationError: true
       x-example:
         - employee:
@@ -6677,6 +6681,7 @@ paths:
                   ExternalLink:
                     Url: http://twitter.com/#!/search/Nick+Fury
     post:
+      deprecated: true
       security:
         - OAuth2:
             - accounting.settings
@@ -6684,6 +6689,7 @@ paths:
         - Accounting
       operationId: updateOrCreateEmployees
       summary: Creates a single new employees used in Xero payrun
+      description: This endpoint is deprecated and will be removed April 28, 2026
       x-hasAccountingValidationError: true
       x-example:
         - employee:
@@ -6758,6 +6764,7 @@ paths:
     parameters:
       - $ref: '#/components/parameters/requiredHeader'
     get:
+      deprecated: true
       security:
         - OAuth2:
             - accounting.settings
@@ -6766,6 +6773,7 @@ paths:
         - Accounting
       operationId: getEmployee
       summary: Retrieves a specific employee used in Xero payrun using a unique employee Id
+      description: This endpoint is deprecated and will be removed April 28, 2026
       parameters:
         - $ref: '#/components/parameters/EmployeeID'
       responses: