From 51da7aa15d9d143f3823c5641e0ae85daf002243 Mon Sep 17 00:00:00 2001
From: Will Molloy <will.molloy@xero.com>
Date: Mon, 13 Apr 2026 15:59:25 +1000
Subject: [PATCH] feat: add CreatedDateUtc and AssociationDateUtc to
 Association schema

Add CreatedDateUtc and AssociationDateUtc properties to the Association schema,
add missing Size and new AssociationDateUtc to the sort enum, and add default
sort by CreatedDateUtc for associations.
---
 xero_files.yaml | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/xero_files.yaml b/xero_files.yaml
index 20f5e5bd7..862df619e 100644
--- a/xero_files.yaml
+++ b/xero_files.yaml
@@ -415,7 +415,10 @@ paths:
             type: string
             enum:
               - Name
-              - CreatedDateUTC
+              - Size
+              - CreatedDateUtc
+              - AssociationDateUtc
+            default: CreatedDateUtc
             example: Associations/{ObjectId}?sort=CreatedDateUtc
         - in: query
           name: direction
@@ -435,7 +438,7 @@ paths:
                 type: array
                 items:
                   $ref: "#/components/schemas/Association"
-              example: '[ { "SendWithObject":false, "Name":"testfile.pdf", "Size":12357, "FileId":"6beccb4a-0d7d-4518-93f3-e0cd1dccb254", "ObjectId":"1270bf7c-5d18-473a-9231-1e36c4bd33ed", "ObjectType":"Business", "ObjectGroup":"Contact" } ]'
+              example: '[ { "SendWithObject":false, "Name":"testfile.pdf", "Size":12357, "CreatedDateUtc":"2020-12-10T01:22:00.0000000", "AssociationDateUtc":"2020-12-10T01:22:00.0000000", "FileId":"6beccb4a-0d7d-4518-93f3-e0cd1dccb254", "ObjectId":"1270bf7c-5d18-473a-9231-1e36c4bd33ed", "ObjectType":"Business", "ObjectGroup":"Contact" } ]'
   /Associations/Count:
     parameters:
       - $ref: "#/components/parameters/requiredHeader"
@@ -828,6 +831,16 @@ components:
           description: The size of the associated file in bytes. Note- The Size element is only returned when using /Associations/{ObjectId} endpoint.
           type: integer
           example: 12357
+        CreatedDateUtc:
+          description: The date the file was created (UTC). Note- The CreatedDateUtc element is only returned when using /Associations/{ObjectId} endpoint.
+          type: string
+          format: date-time
+          example: "2020-12-10T01:22:00.0000000"
+        AssociationDateUtc:
+          description: The date the file was associated with the object (UTC). Note- The AssociationDateUtc element is only returned when using /Associations/{ObjectId} endpoint.
+          type: string
+          format: date-time
+          example: "2020-12-10T01:22:00.0000000"
         FileId:
           description: The unique identifier of the file
           type: string