chore(developer): update API docs (#586)

Author: github-actions[bot]

src/assets/api/enterprise/file-based.yml

@@ -26052,6 +26052,8 @@ components:
             - /includeInContextPseudoLanguage
             - /labelIds
             - /excludeLabelIds
+            - /labelMatchRule
+            - /excludeLabelMatchRule
       type: object
       discriminator:
         propertyName: op
@@ -26094,16 +26096,14 @@ components:
     BundleCreateForm:
       required:
         - name
-        - format
         - sourcePatterns
-        - exportPattern
       properties:
         name:
           description: 'Defines name'
           type: string
           example: 'Resx bundle'
         format:
-          description: 'Defines export file format'
+          description: "Defines export file format. If not provided, files will be exported in their original format.\n\n__Note:__ Required for strings-based projects"
           type: string
           example: crowdin-resx
         sourcePatterns:
@@ -26119,9 +26119,10 @@ components:
             type: string
             example: /masterBranch
         exportPattern:
-          description: "Bundle export pattern. Defines bundle name in resulting translations bundle\n\n__Note:__ Can't contain `: * ? \" < > |` symbols"
+          description: "Bundle export pattern. Defines bundle name in resulting translations bundle. **Required** if `format` is specified. If `format` is not specified, uses default pattern based on file structure\n\n__Note:__ Can't contain `: * ? \" < > |` symbols"
           type: string
           example: strings-%two_letter_code%.resx
+          nullable: true
         isMultilingual:
           description: 'Export translations in multilingual file'
           type: boolean
@@ -26139,21 +26140,47 @@ components:
           type: boolean
           default: true
         labelIds:
-          description: 'Label Identifiers. Get via [List Labels](#operation/api.projects.labels.getMany)'
+          description: "Label Identifiers. Get via [List Labels](#operation/api.projects.labels.getMany)\n\n__Note:__ Can't be used when `format` is `null`"
           type: array
           items:
             type: integer
           example:
             - 13
             - 27
         excludeLabelIds:
-          description: 'Label Identifiers. Get via [List Labels](#operation/api.projects.labels.getMany)'
+          description: "Label Identifiers. Get via [List Labels](#operation/api.projects.labels.getMany)\n\n__Note:__ Can't be used when `format` is `null`"
           type: array
           items:
             type: integer
           example:
             - 5
             - 8
+        labelMatchRule:
+          description: "Match rule for labels:\n- \"all\" - all labels must be present in string\n- \"any\" - any of the labels must be present in string\n\n __Note:__ Can only be used when `labelIds` parameter is provided"
+          type: string
+          default: all
+          enum:
+            - all
+            - any
+          nullable: true
+        excludeLabelMatchRule:
+          description: "Match rule for excluded labels:\n - \"all\" - all labels must be present in string\n - \"any\" - any of the labels must be present in string\n\n __Note:__ Can only be used when `excludeLabelIds` parameter is provided"
+          type: string
+          default: all
+          enum:
+            - all
+            - any
+          nullable: true
+        languageIds:
+          description: 'Language Identifiers. Get via [List Supported Languages](#operation/api.languages.getMany). If provided, bundle will only export specified languages. If not provided, bundle will export all project target languages.'
+          type: array
+          items:
+            type: string
+          example:
+            - uk
+            - de
+            - fr
+          nullable: true
       type: object
     BundleCollectionResource:
       description: 'Bundle Collection Resource'
@@ -26242,6 +26269,7 @@ components:
         format:
           type: string
           example: crowdin-resx
+          nullable: true
         sourcePatterns:
           type: array
           items:
@@ -26255,6 +26283,7 @@ components:
         exportPattern:
           type: string
           example: strings-%two_letters_code%.resx
+          nullable: true
         isMultilingual:
           type: boolean
           default: false
@@ -26267,6 +26296,20 @@ components:
         sourceLanguageExportPattern:
           type: string
           example: strings-%two_letters_code%.resx
+        labelMatchRule:
+          type: string
+          enum:
+            - all
+            - any
+          example: all
+          nullable: true
+        excludeLabelMatchRule:
+          type: string
+          enum:
+            - all
+            - any
+          example: any
+          nullable: true
         labelIds:
           type: array
           items:
@@ -26281,6 +26324,15 @@ components:
           example:
             - 5
             - 8
+        languageIds:
+          type: array
+          items:
+            type: string
+          example:
+            - uk
+            - de
+            - fr
+          nullable: true
         webUrl:
           type: string
           example: 'https://crowdin.com/project/test/translations#bundles:100'
@@ -27740,7 +27792,8 @@ components:
           enum:
             - default
             - bundle
-          example: bundle
+          example: default
+          deprecated: true
         name:
           description: 'Distribution name'
           type: string
@@ -27754,6 +27807,7 @@ components:
             - 24
             - 25
             - 38
+          deprecated: true
         bundleIds:
           description: "Bundles ids. Get via [List Bundles](#operation/api.projects.bundles.getMany)\n\n__Note:__ Required for `bundle` export mode"
           type: array
@@ -44925,6 +44979,7 @@ components:
             - /fields
             - '/fields/{fieldSlug}'
             - /generateCostEstimate
+            - /generateTranslationCost
             - /reportSettingsTemplateId
           x-doc-sections:
             - file-based
@@ -45011,6 +45066,7 @@ components:
             - /excludeLabelIds
             - /excludeLabelMatchRule
             - /generateCostEstimate
+            - /generateTranslationCost
             - /reportSettingsTemplateId
           x-doc-sections:
             - file-based
@@ -45426,8 +45482,13 @@ components:
           type: boolean
           default: false
           example: false
+        generateTranslationCost:
+          description: 'Generate translation cost report for the task. Requires `reportSettingsTemplateId`'
+          type: boolean
+          default: false
+          example: false
         reportSettingsTemplateId:
-          description: 'Report Settings Templates Identifier. Get via [List Report Settings Templates](#operation/api.reports.settings-templates.getMany). Required when `generateCostEstimate` is `true`'
+          description: 'Report Settings Templates Identifier. Get via [List Report Settings Templates](#operation/api.reports.settings-templates.getMany). Required when `generateCostEstimate` or `generateTranslationCost` is `true`'
           type: integer
           example: 1
           nullable: true
@@ -45546,8 +45607,13 @@ components:
           type: boolean
           default: false
           example: false
+        generateTranslationCost:
+          description: 'Generate translation cost report for the task. Requires `reportSettingsTemplateId`'
+          type: boolean
+          default: false
+          example: false
         reportSettingsTemplateId:
-          description: 'Report Settings Templates Identifier. Get via [List Report Settings Templates](#operation/api.reports.settings-templates.getMany). Required when `generateCostEstimate` is `true`'
+          description: 'Report Settings Templates Identifier. Get via [List Report Settings Templates](#operation/api.reports.settings-templates.getMany). Required when `generateCostEstimate` or `generateTranslationCost` is `true`'
           type: integer
           example: 1
           nullable: true
@@ -45673,8 +45739,13 @@ components:
           type: boolean
           default: false
           example: false
+        generateTranslationCost:
+          description: 'Generate translation cost report for the task. Requires `reportSettingsTemplateId`'
+          type: boolean
+          default: false
+          example: false
         reportSettingsTemplateId:
-          description: 'Report Settings Templates Identifier. Get via [List Report Settings Templates](#operation/api.reports.settings-templates.getMany). Required when `generateCostEstimate` is `true`'
+          description: 'Report Settings Templates Identifier. Get via [List Report Settings Templates](#operation/api.reports.settings-templates.getMany). Required when `generateCostEstimate` or `generateTranslationCost` is `true`'
           type: integer
           example: 1
           nullable: true
@@ -45769,8 +45840,13 @@ components:
           type: boolean
           default: false
           example: false
+        generateTranslationCost:
+          description: 'Generate translation cost report for the task. Requires `reportSettingsTemplateId`'
+          type: boolean
+          default: false
+          example: false
         reportSettingsTemplateId:
-          description: 'Report Settings Templates Identifier. Get via [List Report Settings Templates](#operation/api.reports.settings-templates.getMany). Required when `generateCostEstimate` is `true`'
+          description: 'Report Settings Templates Identifier. Get via [List Report Settings Templates](#operation/api.reports.settings-templates.getMany). Required when `generateCostEstimate` or `generateTranslationCost` is `true`'
           type: integer
           example: 1
           nullable: true
@@ -46334,6 +46410,11 @@ components:
         generateCostEstimate:
           type: boolean
           example: true
+          nullable: true
+        generateTranslationCost:
+          type: boolean
+          example: true
+          nullable: true
         reportSettingsTemplateId:
           type: integer
           example: 1