feat(openapi): add cdn file endpoint and enhance ai detection in docx to pdf conversion

Author: fern-api[bot]

openapi.yml

@@ -37,21 +37,88 @@ components:
           example: Bad request
       title: ErrorSchema
 paths:
-  /status/:
+  /cdn/file/:
     get:
-      operationId: getStatus
-      description: Get the status of the API
-      x-fern-availability: generally-available
+      operationId: file
+      summary: Get a file using a presigned URL
+      tags:
+        - CDN
+      description: >-
+        This endpoint is used to get a file using a presigned URL. The presigned
+        URL is generated by the API and should be used to avoid region mismatch.
+      parameters:
+        - schema:
+            type: string
+          in: query
+          name: b
+          required: true
+          description: >-
+            Storage bucket identifier. Note that storage buckets are region
+            specific, so you should be using the presigned URL provided by the
+            API to avoid region mismatch.
+        - schema:
+            type: string
+          in: query
+          name: f
+          required: true
+          description: File path. Pay attention to URL encode the file path if needed.
+        - schema:
+            type: string
+          in: query
+          name: u
+          required: false
+          description: >-
+            Bucket username. This is an automatically generated user when the
+            presigned URL is created.
+        - schema:
+            type: string
+          in: query
+          name: p
+          required: false
+          description: >-
+            Bucket password. This is an automatically generated password when
+            the presigned URL is created.
+        - schema:
+            type: string
+          in: query
+          name: t
+          required: false
+          description: Presigned URL expiration timestamp, in milliseconds
+        - schema:
+            type: string
+          in: query
+          name: s
+          required: true
+          description: Presigned URL signature
+      x-fern-sdk-group-name:
+        - cdn
+      x-fern-sdk-method-name: getFile
+      x-fern-availability: beta
       responses:
         '200':
-          description: Default Response
+          description: The file content
           content:
             application/json:
               schema:
-                type: object
-                properties:
-                  status:
-                    type: string
+                type: string
+                format: binary
+                description: The file content
+        '400':
+          description: Bad request
+          content:
+            application/json:
+              schema:
+                description: Bad request
+                $ref: '#/components/schemas/def-0'
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                description: Unauthorized
+                $ref: '#/components/schemas/def-0'
+        '500':
+          description: Internal server error
   /pdf/docx/:
     post:
       operationId: convertDOCXtoPDF
@@ -398,7 +465,15 @@ paths:
               properties:
                 options:
                   type: object
-                  properties: {}
+                  properties:
+                    aiDetection:
+                      type: object
+                      properties:
+                        enable:
+                          type: boolean
+                          default: false
+                        limit:
+                          type: number
                 file:
                   type: string
                   format: binary
@@ -430,6 +505,16 @@ paths:
                       type: boolean
                     readOnly:
                       type: boolean
+                    aiDetectedName:
+                      type: object
+                      required:
+                        - name
+                        - score
+                      properties:
+                        name:
+                          type: string
+                        score:
+                          type: number
                     locations:
                       type: array
                       items:
@@ -979,11 +1064,26 @@ paths:
                 $ref: '#/components/schemas/def-0'
         '500':
           description: Internal server error
+  /status/:
+    get:
+      operationId: getStatus
+      description: Get the status of the API
+      x-fern-availability: generally-available
+      responses:
+        '200':
+          description: Default Response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status:
+                    type: string
 servers:
   - url: https://api.fileforge.com
-    description: Tunnel server
-  - url: http://localhost:3000
-    description: Development server
+    description: Global Server
+  - url: https://us-west-1.api.fileforge.com
+    description: Regional Server
 tags:
   - name: PDF
     description: PDF operations