feat(API): add updated_since param for downloads (#858)

Author: theSoenke

.github/workflows/test-ruby.yml

@@ -21,7 +21,7 @@ jobs:
           cd ./clients/ruby
           bundle exec rspec
       - name: Check licenses
-        uses: phrase/actions/lawa-ruby-ci@v1
+        uses: phrase/actions/lawa-ruby-ci@main
         with:
           working-directory: ./clients/ruby
           github-token: ${{ secrets.GH_LAWA_ACCESS_TOKEN }}

clients/java/src/test/java/com/phrase/client/api/LocalesApiTest.java

@@ -172,12 +172,13 @@ public void localeDownloadTest() throws ApiException, IOException, InterruptedEx
         String translationKeyPrefix = null;
         Boolean filterByPrefix = null;
         List<String> localeIds = null;
+        String updatedSince = null;
         File response = api.localeDownload(projectId, id, xPhraseAppOTP, ifModifiedSince, ifNoneMatch,
             branch, fileFormat, tags, tag, includeEmptyTranslations, excludeEmptyZeroForms,
             includeTranslatedKeys, keepNotranslateTags, convertEmoji, formatOptions, encoding,
             skipUnverifiedTranslations, includeUnverifiedTranslations, useLastReviewedVersion,
             fallbackLocaleId, sourceLocaleId, translationKeyPrefix, filterByPrefix,
-            customMetadataFilters, localeIds);
+            customMetadataFilters, localeIds, updatedSince);
 
         String fileContents = new String(java.nio.file.Files.readAllBytes(response.toPath()));
         Assert.assertEquals("Correct file contents", fileContents, body);

clients/ruby/.license-decisions.yml

@@ -2,3 +2,9 @@
 - - :inherit_from
   - url: https://raw.githubusercontent.com/phrase/lawa/master/config/license-decisions.yml
     authorization: token $GITHUB_TOKEN
+- - :approve
+  - json
+  - :who: Sönke Behrendt
+    :why: ruby license
+    :versions: []
+    :when: 2025-07-08 15:04:25.587413000 Z

doc/compiled.json

@@ -8671,6 +8671,15 @@
               "de",
               "en"
             ]
+          },
+          {
+            "name": "updated_since",
+            "description": "Only include keys that have been updated since the given date. The date must be in ISO 8601 format (e.g., `2023-01-01T00:00:00Z`).\n",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            },
+            "example": "2023-01-01T00:00:00Z"
           }
         ],
         "responses": {
@@ -8835,6 +8844,10 @@
                     "description": "Custom metadata filters. Provide the name of the metadata field and the value to filter by. Only keys with matching metadata will be included in the download.\n",
                     "type": "object",
                     "properties": {}
+                  },
+                  "updated_since": {
+                    "description": "Only include keys that have been updated since the given date. The date must be in ISO 8601 format (e.g., `2023-01-01T00:00:00Z`).\n",
+                    "type": "string"
                   }
                 }
               }

paths/locale_downloads/create.yaml

@@ -85,6 +85,10 @@ requestBody:
               Custom metadata filters. Provide the name of the metadata field and the value to filter by. Only keys with matching metadata will be included in the download.
             type: object
             properties: {}
+          updated_since:
+            description: |
+              Only include keys that have been updated since the given date. The date must be in ISO 8601 format (e.g., `2023-01-01T00:00:00Z`).
+            type: string
 responses:
   "201":
     description: Created

paths/locales/download.yaml

@@ -143,6 +143,13 @@ parameters:
     example:
       - de
       - en
+  - name: updated_since
+    description: |
+      Only include keys that have been updated since the given date. The date must be in ISO 8601 format (e.g., `2023-01-01T00:00:00Z`).
+    in: query
+    schema:
+      type: string
+    example: "2023-01-01T00:00:00Z"
 responses:
   "200":
     description: OK