Fix all quality validation issues and enable strict mode

- Add missing parameter descriptions (days, org_ids, has_handled,
  external_link_token, view_external_link_token, invite_link_token, q)
- Add missing endpoint descriptions (4 custom folder endpoints)
- Add missing response content (unarchive, admin export, org-basic-info)
- Enable --strict mode in workflow quality check

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: christophdb

.github/workflows/rdme-openapi.yml

@@ -73,7 +73,7 @@ jobs:
       - name: Check documentation quality
         run: |
           pip install pyyaml -q
-          python3 tests/validate_specs.py
+          python3 tests/validate_specs.py --strict
 
       - name: Update SeaTable API docs
         uses: readmeio/rdme@v9

base_operations.yaml

@@ -176,6 +176,7 @@ components:
       example: 0
     days:
       name: days
+      description: Number of days to look back for comments.
       in: query
       schema:
         type: integer
@@ -3953,6 +3954,13 @@ paths:
       responses:
         "200":
           description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+              example:
+                success: true
+                task_id: cdb7fcc6-d2fa-4bf7-ae08-0d767c38690c
   /api-gateway/api/v2/dtables/{base_uuid}/db-operations/:
     get:
       tags: [Big Data]

file_operations.yaml

@@ -301,6 +301,7 @@ paths:
       tags: [Files & Images (Custom Folder)]
       summary: Get Files from Folder
       operationId: getCustomFiles
+      description: List files and subdirectories in a custom folder of a base.
       security:
         - ApiTokenAuth: []
       parameters:
@@ -324,6 +325,7 @@ paths:
       tags: [Files & Images (Custom Folder)]
       summary: Get File Metadata
       operationId: getCustomFileMetadata
+      description: Get metadata (name, size, last update) of a file in a custom folder.
       security:
         - ApiTokenAuth: []
       parameters:
@@ -368,6 +370,7 @@ paths:
       tags: [Files & Images (Custom Folder)]
       summary: Get Upload Link
       operationId: getCustomUploadLink
+      description: Get a temporary upload link for uploading files to a custom folder.
       security:
         - ApiTokenAuth: []
       parameters:
@@ -390,6 +393,7 @@ paths:
       tags: [Files & Images (Custom Folder)]
       summary: Get Download Link
       operationId: getCustomDownloadLink
+      description: Get a temporary download link for a file in a custom folder.
       security:
         - ApiTokenAuth: []
       parameters:

system_admin_account_operations.yaml

@@ -1996,6 +1996,7 @@ paths:
       parameters:
         - name: org_ids
           in: query
+          description: Comma-separated list of organization IDs to look up.
           schema:
             type: array
             items:
@@ -2004,6 +2005,14 @@ paths:
       responses:
         "200":
           description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+              example:
+                organization_list:
+                  - org_id: 1
+                    org_name: "My Team"
   /api/v2.1/admin/organizations/{org_id}/:
     put:
       tags:
@@ -2367,6 +2376,9 @@ paths:
       responses:
         "200":
           description: OK
+          content:
+            # Actually application/x-zip-compressed, but dtable-web does not accept this in Accept header
+            application/json: {}
 
   # Common Dataset
   /api/v2.1/admin/common-datasets/:
@@ -3568,6 +3580,7 @@ paths:
         - $ref: "#/components/parameters/per_page"
         - in: query
           name: has_handled
+          description: Filter by handling status. Use `true` for handled, `false` for unhandled, or `null` for all.
           schema:
             type: string
             enum: [true, false, null]

team_admin_account_operations.yaml

@@ -170,20 +170,23 @@ components:
       example: 5c264e76-0e5a-448a-9f34-580b551364ca
     external_link_token:
       name: external_link_token
+      description: The token of the external link.
       in: path
       schema:
         type: string
       required: true
       example: "d6d006b319ca4d2aa060"
     view_external_link_token:
       name: view_external_link_token
+      description: The token of the view external link.
       in: path
       schema:
         type: string
       required: true
       example: "d6d006b319ca4d2aa060"
     invite_link_token:
       name: invite_link_token
+      description: The token of the invite link.
       in: path
       schema:
         type: string

user_account_operations.yaml

@@ -2485,6 +2485,7 @@ paths:
       parameters:
         - name: q
           in: query
+          description: Search query string. Matches against email, name, or contact email.
           schema:
             type: string
           example: Micha
@@ -3415,6 +3416,7 @@ paths:
       parameters:
         - name: q
           in: query
+          description: Search query string. Matches against group name.
           schema:
             type: string
           example: Micha
@@ -3558,6 +3560,7 @@ paths:
       parameters:
         - name: q
           in: query
+          description: Search query string. Matches against member name or email.
           schema:
             type: string
           example: Micha