Deploying from phrase/strings-openapi@ccea7e19

Author: Phrase

api/openapi.yaml

@@ -15371,6 +15371,8 @@ paths:
       description: |
         Upload a new language file. Creates necessary resources in your project.
 
+        The upload is processed asynchronously: this endpoint returns `201 Created` once the file has been accepted and enqueued, not once processing has finished. Poll `GET /projects/{project_id}/uploads/{id}` and check the `state` field — `error` means processing failed (for example, an unparseable file or a `file_format` that doesn't match the file's actual content).
+
         Note: be aware of [upload limits](https://support.phrase.com/hc/en-us/articles/8548271212188-Phrase-Strings-Limits#file-size-upload-limits-0-0).
       operationId: upload/create
       parameters:
@@ -15486,7 +15488,6 @@ paths:
             -X POST \
             -F branch=my-feature-branch \
             -F file=@/path/to/my/file.json \
-            -F file_format=json \
             -F locale_id=abcd1234cdef1234abcd1234cdef1234 \
             -F tags=awesome-feature,needs-proofreading \
             -F locale_mapping[en]=2 \
@@ -15497,7 +15498,6 @@ paths:
           --project_id <project_id> \
           --branch my-feature-branch \
           --file /path/to/my/file.json \
-          --file_format json \
           --locale_id abcd1234cdef1234abcd1234cdef1234 \
           --tags awesome-feature,needs-proofreading \
           --locale_mapping '{"en": "2"}' \
@@ -15508,7 +15508,8 @@ paths:
       x-accepts: application/json
   /projects/{project_id}/uploads/{id}:
     get:
-      description: View details and summary for a single upload.
+      description: |
+        View details and summary for a single upload. Use this endpoint to poll for the outcome of an upload created via `POST /projects/{project_id}/uploads` — check the `state` field.
       operationId: upload/show
       parameters:
       - description: Two-Factor-Authentication token (optional)
@@ -39467,6 +39468,8 @@ components:
         format:
           type: string
         state:
+          description: |
+            Processing state of the upload: `initialized`, `processing`, `success`, or `error`. `error` means processing failed — for example the file could not be parsed, or a provided `file_format` didn't match the file's actual content. Poll this field until it leaves `initialized`/`processing` to get the final outcome.
           type: string
         error_message:
           description: |
@@ -43366,7 +43369,10 @@ components:
           format: binary
           type: string
         file_format:
-          description: File format. Auto-detected when possible and not specified.
+          description: |
+            File format of the uploaded file, given as a format's `api_name`. See our [Formats API Endpoint](/en/api/strings/formats/list-formats) for the full list of supported formats.
+
+            Optional. When omitted, Phrase tries to auto-detect the format from the file's content. This is not always possible for JSON files, since several JSON-based formats (e.g. `json`, `simple_json`, `nested_json`) share the same structure.
           example: json
           type: string
         locale_id:

docs/Upload.md

@@ -9,7 +9,7 @@ Name | Type | Description | Notes
 **id** | **String** |  |  [optional]
 **filename** | **String** |  |  [optional]
 **format** | **String** |  |  [optional]
-**state** | **String** |  |  [optional]
+**state** | **String** | Processing state of the upload: `initialized`, `processing`, `success`, or `error`. `error` means processing failed — for example the file could not be parsed, or a provided `file_format` didn't match the file's actual content. Poll this field until it leaves `initialized`/`processing` to get the final outcome.  |  [optional]
 **errorMessage** | **String** | A user-facing message explaining why the upload failed, or `null` if the upload did not fail.  This message is intended for display only. Its wording may change at any time and it should not be parsed or relied upon programmatically.  |  [optional]
 **tag** | **String** | Unique tag of the upload  |  [optional]
 **tags** | **List<String>** | List of tags that were assigned to the uploaded keys  |  [optional]

docs/UploadsApi.md

@@ -15,7 +15,7 @@ Method | HTTP request | Description
 
 Upload a new file
 
-Upload a new language file. Creates necessary resources in your project.  Note: be aware of [upload limits](https://support.phrase.com/hc/en-us/articles/8548271212188-Phrase-Strings-Limits#file-size-upload-limits-0-0). 
+Upload a new language file. Creates necessary resources in your project.  The upload is processed asynchronously: this endpoint returns `201 Created` once the file has been accepted and enqueued, not once processing has finished. Poll `GET /projects/{project_id}/uploads/{id}` and check the `state` field — `error` means processing failed (for example, an unparseable file or a `file_format` that doesn't match the file's actual content).  Note: be aware of [upload limits](https://support.phrase.com/hc/en-us/articles/8548271212188-Phrase-Strings-Limits#file-size-upload-limits-0-0). 
 
 ### Example
 ```java
@@ -45,7 +45,7 @@ public class Example {
     UploadsApi apiInstance = new UploadsApi(defaultClient);
     String projectId = "projectId_example"; // String | Project ID
     File _file = new File("/path/to/file"); // File | File to be imported
-    String fileFormat = "fileFormat_example"; // String | File format. Auto-detected when possible and not specified.
+    String fileFormat = "fileFormat_example"; // String | File format of the uploaded file, given as a format's `api_name`. See our [Formats API Endpoint](/en/api/strings/formats/list-formats) for the full list of supported formats.  Optional. When omitted, Phrase tries to auto-detect the format from the file's content. This is not always possible for JSON files, since several JSON-based formats (e.g. `json`, `simple_json`, `nested_json`) share the same structure. 
     String localeId = "localeId_example"; // String | Locale of the file's content. Can be the name or id of the locale. Preferred is id.
     String xPhraseAppOTP = "xPhraseAppOTP_example"; // String | Two-Factor-Authentication token (optional)
     String branch = "branch_example"; // String | specify the branch to use
@@ -88,7 +88,7 @@ Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **projectId** | **String**| Project ID |
  **_file** | **File**| File to be imported |
- **fileFormat** | **String**| File format. Auto-detected when possible and not specified. |
+ **fileFormat** | **String**| File format of the uploaded file, given as a format's `api_name`. See our [Formats API Endpoint](/en/api/strings/formats/list-formats) for the full list of supported formats.  Optional. When omitted, Phrase tries to auto-detect the format from the file's content. This is not always possible for JSON files, since several JSON-based formats (e.g. `json`, `simple_json`, `nested_json`) share the same structure.  |
  **localeId** | **String**| Locale of the file's content. Can be the name or id of the locale. Preferred is id. |
  **xPhraseAppOTP** | **String**| Two-Factor-Authentication token (optional) | [optional]
  **branch** | **String**| specify the branch to use | [optional]
@@ -142,7 +142,7 @@ Name | Type | Description  | Notes
 
 Get a single upload
 
-View details and summary for a single upload.
+View details and summary for a single upload. Use this endpoint to poll for the outcome of an upload created via `POST /projects/{project_id}/uploads` — check the `state` field. 
 
 ### Example
 ```java

src/main/java/com/phrase/client/ApiException.java

@@ -15,7 +15,7 @@
 import java.util.Map;
 import java.util.List;
 
-@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", date = "2026-09-11T11:11:06.552180239Z[Etc/UTC]")
+@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", date = "2026-09-11T12:31:16.760733738Z[Etc/UTC]")
 public class ApiException extends Exception {
     private int code = 0;
     private Map<String, List<String>> responseHeaders = null;

src/main/java/com/phrase/client/Configuration.java

@@ -12,7 +12,7 @@
 
 package com.phrase.client;
 
-@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", date = "2026-09-11T11:11:06.552180239Z[Etc/UTC]")
+@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", date = "2026-09-11T12:31:16.760733738Z[Etc/UTC]")
 public class Configuration {
     private static ApiClient defaultApiClient = new ApiClient();
 

src/main/java/com/phrase/client/Pair.java

@@ -12,7 +12,7 @@
 
 package com.phrase.client;
 
-@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", date = "2026-09-11T11:11:06.552180239Z[Etc/UTC]")
+@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", date = "2026-09-11T12:31:16.760733738Z[Etc/UTC]")
 public class Pair {
     private String name = "";
     private String value = "";

src/main/java/com/phrase/client/StringUtil.java

@@ -12,7 +12,7 @@
 
 package com.phrase.client;
 
-@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", date = "2026-09-11T11:11:06.552180239Z[Etc/UTC]")
+@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", date = "2026-09-11T12:31:16.760733738Z[Etc/UTC]")
 public class StringUtil {
   /**
    * Check if the given array contains the given value (with case-insensitive comparison).

src/main/java/com/phrase/client/api/UploadsApi.java

@@ -59,7 +59,7 @@ public void setApiClient(ApiClient apiClient) {
      * Build call for uploadCreate
      * @param projectId Project ID (required)
      * @param _file File to be imported (required)
-     * @param fileFormat File format. Auto-detected when possible and not specified. (required)
+     * @param fileFormat File format of the uploaded file, given as a format's `api_name`. See our [Formats API Endpoint](/en/api/strings/formats/list-formats) for the full list of supported formats.  Optional. When omitted, Phrase tries to auto-detect the format from the file's content. This is not always possible for JSON files, since several JSON-based formats (e.g. `json`, `simple_json`, `nested_json`) share the same structure.  (required)
      * @param localeId Locale of the file's content. Can be the name or id of the locale. Preferred is id. (required)
      * @param xPhraseAppOTP Two-Factor-Authentication token (optional) (optional)
      * @param branch specify the branch to use (optional)
@@ -254,10 +254,10 @@ private okhttp3.Call uploadCreateValidateBeforeCall(String projectId, File _file
 
     /**
      * Upload a new file
-     * Upload a new language file. Creates necessary resources in your project.  Note: be aware of [upload limits](https://support.phrase.com/hc/en-us/articles/8548271212188-Phrase-Strings-Limits#file-size-upload-limits-0-0). 
+     * Upload a new language file. Creates necessary resources in your project.  The upload is processed asynchronously: this endpoint returns `201 Created` once the file has been accepted and enqueued, not once processing has finished. Poll `GET /projects/{project_id}/uploads/{id}` and check the `state` field — `error` means processing failed (for example, an unparseable file or a `file_format` that doesn't match the file's actual content).  Note: be aware of [upload limits](https://support.phrase.com/hc/en-us/articles/8548271212188-Phrase-Strings-Limits#file-size-upload-limits-0-0). 
      * @param projectId Project ID (required)
      * @param _file File to be imported (required)
-     * @param fileFormat File format. Auto-detected when possible and not specified. (required)
+     * @param fileFormat File format of the uploaded file, given as a format's `api_name`. See our [Formats API Endpoint](/en/api/strings/formats/list-formats) for the full list of supported formats.  Optional. When omitted, Phrase tries to auto-detect the format from the file's content. This is not always possible for JSON files, since several JSON-based formats (e.g. `json`, `simple_json`, `nested_json`) share the same structure.  (required)
      * @param localeId Locale of the file's content. Can be the name or id of the locale. Preferred is id. (required)
      * @param xPhraseAppOTP Two-Factor-Authentication token (optional) (optional)
      * @param branch specify the branch to use (optional)
@@ -301,10 +301,10 @@ public Upload uploadCreate(String projectId, File _file, String fileFormat, Stri
 
     /**
      * Upload a new file
-     * Upload a new language file. Creates necessary resources in your project.  Note: be aware of [upload limits](https://support.phrase.com/hc/en-us/articles/8548271212188-Phrase-Strings-Limits#file-size-upload-limits-0-0). 
+     * Upload a new language file. Creates necessary resources in your project.  The upload is processed asynchronously: this endpoint returns `201 Created` once the file has been accepted and enqueued, not once processing has finished. Poll `GET /projects/{project_id}/uploads/{id}` and check the `state` field — `error` means processing failed (for example, an unparseable file or a `file_format` that doesn't match the file's actual content).  Note: be aware of [upload limits](https://support.phrase.com/hc/en-us/articles/8548271212188-Phrase-Strings-Limits#file-size-upload-limits-0-0). 
      * @param projectId Project ID (required)
      * @param _file File to be imported (required)
-     * @param fileFormat File format. Auto-detected when possible and not specified. (required)
+     * @param fileFormat File format of the uploaded file, given as a format's `api_name`. See our [Formats API Endpoint](/en/api/strings/formats/list-formats) for the full list of supported formats.  Optional. When omitted, Phrase tries to auto-detect the format from the file's content. This is not always possible for JSON files, since several JSON-based formats (e.g. `json`, `simple_json`, `nested_json`) share the same structure.  (required)
      * @param localeId Locale of the file's content. Can be the name or id of the locale. Preferred is id. (required)
      * @param xPhraseAppOTP Two-Factor-Authentication token (optional) (optional)
      * @param branch specify the branch to use (optional)
@@ -349,10 +349,10 @@ public ApiResponse<Upload> uploadCreateWithHttpInfo(String projectId, File _file
 
     /**
      * Upload a new file (asynchronously)
-     * Upload a new language file. Creates necessary resources in your project.  Note: be aware of [upload limits](https://support.phrase.com/hc/en-us/articles/8548271212188-Phrase-Strings-Limits#file-size-upload-limits-0-0). 
+     * Upload a new language file. Creates necessary resources in your project.  The upload is processed asynchronously: this endpoint returns &#x60;201 Created&#x60; once the file has been accepted and enqueued, not once processing has finished. Poll &#x60;GET /projects/{project_id}/uploads/{id}&#x60; and check the &#x60;state&#x60; field — &#x60;error&#x60; means processing failed (for example, an unparseable file or a &#x60;file_format&#x60; that doesn&#39;t match the file&#39;s actual content).  Note: be aware of [upload limits](https://support.phrase.com/hc/en-us/articles/8548271212188-Phrase-Strings-Limits#file-size-upload-limits-0-0). 
      * @param projectId Project ID (required)
      * @param _file File to be imported (required)
-     * @param fileFormat File format. Auto-detected when possible and not specified. (required)
+     * @param fileFormat File format of the uploaded file, given as a format&#39;s &#x60;api_name&#x60;. See our [Formats API Endpoint](/en/api/strings/formats/list-formats) for the full list of supported formats.  Optional. When omitted, Phrase tries to auto-detect the format from the file&#39;s content. This is not always possible for JSON files, since several JSON-based formats (e.g. &#x60;json&#x60;, &#x60;simple_json&#x60;, &#x60;nested_json&#x60;) share the same structure.  (required)
      * @param localeId Locale of the file&#39;s content. Can be the name or id of the locale. Preferred is id. (required)
      * @param xPhraseAppOTP Two-Factor-Authentication token (optional) (optional)
      * @param branch specify the branch to use (optional)
@@ -477,7 +477,7 @@ private okhttp3.Call uploadShowValidateBeforeCall(String projectId, String id, S
 
     /**
      * Get a single upload
-     * View details and summary for a single upload.
+     * View details and summary for a single upload. Use this endpoint to poll for the outcome of an upload created via &#x60;POST /projects/{project_id}/uploads&#x60; — check the &#x60;state&#x60; field. 
      * @param projectId Project ID (required)
      * @param id ID (required)
      * @param xPhraseAppOTP Two-Factor-Authentication token (optional) (optional)
@@ -502,7 +502,7 @@ public Upload uploadShow(String projectId, String id, String xPhraseAppOTP, Stri
 
     /**
      * Get a single upload
-     * View details and summary for a single upload.
+     * View details and summary for a single upload. Use this endpoint to poll for the outcome of an upload created via &#x60;POST /projects/{project_id}/uploads&#x60; — check the &#x60;state&#x60; field. 
      * @param projectId Project ID (required)
      * @param id ID (required)
      * @param xPhraseAppOTP Two-Factor-Authentication token (optional) (optional)
@@ -528,7 +528,7 @@ public ApiResponse<Upload> uploadShowWithHttpInfo(String projectId, String id, S
 
     /**
      * Get a single upload (asynchronously)
-     * View details and summary for a single upload.
+     * View details and summary for a single upload. Use this endpoint to poll for the outcome of an upload created via &#x60;POST /projects/{project_id}/uploads&#x60; — check the &#x60;state&#x60; field. 
      * @param projectId Project ID (required)
      * @param id ID (required)
      * @param xPhraseAppOTP Two-Factor-Authentication token (optional) (optional)

src/main/java/com/phrase/client/auth/ApiKeyAuth.java

@@ -17,7 +17,7 @@
 import java.util.Map;
 import java.util.List;
 
-@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", date = "2026-09-11T11:11:06.552180239Z[Etc/UTC]")
+@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", date = "2026-09-11T12:31:16.760733738Z[Etc/UTC]")
 public class ApiKeyAuth implements Authentication {
   private final String location;
   private final String paramName;

src/main/java/com/phrase/client/auth/HttpBearerAuth.java

@@ -17,7 +17,7 @@
 import java.util.Map;
 import java.util.List;
 
-@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", date = "2026-09-11T11:11:06.552180239Z[Etc/UTC]")
+@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", date = "2026-09-11T12:31:16.760733738Z[Etc/UTC]")
 public class HttpBearerAuth implements Authentication {
   private final String scheme;
   private String bearerToken;