chore: update OpenAPI spec from monorepo (#720)

Co-authored-by: OpenRouter SDK Bot <sdk-bot@openrouter.ai>

Author: openrouter-docs-sync[bot]

.speakeasy/in.openapi.yaml

@@ -29388,6 +29388,127 @@ paths:
       tags:
         - 'Containers'
       x-hidden: true
+  /containers/{container_id}/files/{file_id}/promote:
+    post:
+      description: 'Copies a file from the container''s sandbox prefix into the workspace''s durable document storage, so it outlives the container. Returns the new document in the Files API shape, with a durable file id in the documents namespace. The copy counts against the workspace''s storage quota exactly like an upload.'
+      operationId: 'promoteContainerFile'
+      parameters:
+        - description: 'The canonical container id, exactly as returned in a bash/shell tool result — a restarted session has its own `-r<nonce>`-suffixed id. A session-derived id is always `sess_` + the sanitized session key, which is not necessarily the raw session id that was sent.'
+          in: 'path'
+          name: 'container_id'
+          required: true
+          schema:
+            description: 'The canonical container id, exactly as returned in a bash/shell tool result — a restarted session has its own `-r<nonce>`-suffixed id. A session-derived id is always `sess_` + the sanitized session key, which is not necessarily the raw session id that was sent.'
+            example: 'sess_abc123'
+            type: 'string'
+        - description: 'Container file id (`cfile_` + base64url of the file path).'
+          in: 'path'
+          name: 'file_id'
+          required: true
+          schema:
+            description: 'Container file id (`cfile_` + base64url of the file path).'
+            example: 'cfile_b3V0L3JlcG9ydC5jc3Y'
+            type: 'string'
+      responses:
+        '200':
+          content:
+            application/json:
+              example:
+                _shape: 'openrouter'
+                created_at: '2026-08-23T00:00:00Z'
+                downloadable: false
+                filename: 'out/report.csv'
+                id: 'or_file_011CNha8iCJcU1wXNR6q4V8w'
+                mime_type: 'text/csv'
+                size_bytes: 123
+                type: 'file'
+              schema:
+                $ref: '#/components/schemas/FileResponse'
+          description: 'The promoted file, as a workspace document.'
+        '400':
+          content:
+            application/json:
+              example:
+                error:
+                  code: 400
+                  message: 'Invalid request parameters'
+              schema:
+                $ref: '#/components/schemas/BadRequestResponse'
+          description: 'Bad Request - Invalid request parameters or malformed input'
+        '401':
+          content:
+            application/json:
+              example:
+                error:
+                  code: 401
+                  message: 'Missing Authentication header'
+              schema:
+                $ref: '#/components/schemas/UnauthorizedResponse'
+          description: 'Unauthorized - Authentication required or invalid credentials'
+        '403':
+          content:
+            application/json:
+              example:
+                error:
+                  code: 403
+                  message: 'Only management keys can perform this operation'
+              schema:
+                $ref: '#/components/schemas/ForbiddenResponse'
+          description: 'Forbidden - Authentication successful but insufficient permissions'
+        '404':
+          content:
+            application/json:
+              example:
+                error:
+                  code: 404
+                  message: 'Resource not found'
+              schema:
+                $ref: '#/components/schemas/NotFoundResponse'
+          description: 'Not Found - Resource does not exist'
+        '413':
+          content:
+            application/json:
+              example:
+                error:
+                  code: 413
+                  message: 'Request payload too large'
+              schema:
+                $ref: '#/components/schemas/PayloadTooLargeResponse'
+          description: 'Payload Too Large - Request payload exceeds size limits'
+        '429':
+          content:
+            application/json:
+              example:
+                error:
+                  code: 429
+                  message: 'Rate limit exceeded'
+              schema:
+                $ref: '#/components/schemas/TooManyRequestsResponse'
+          description: 'Too Many Requests - Rate limit exceeded'
+        '500':
+          content:
+            application/json:
+              example:
+                error:
+                  code: 500
+                  message: 'Internal Server Error'
+              schema:
+                $ref: '#/components/schemas/InternalServerResponse'
+          description: 'Internal Server Error - Unexpected server error'
+        '503':
+          content:
+            application/json:
+              example:
+                error:
+                  code: 503
+                  message: 'Service temporarily unavailable'
+              schema:
+                $ref: '#/components/schemas/ServiceUnavailableResponse'
+          description: 'Service Unavailable - Service temporarily unavailable'
+      summary: 'Promote a container file into workspace documents'
+      tags:
+        - 'Containers'
+      x-hidden: true
   /credits:
     get:
       description: 'Get total credits purchased and used for the authenticated user. [Management key](/docs/guides/overview/auth/management-api-keys) required.'