docs(files): declare the conflict response on replace file content

Author: waleedlatif1

apps/docs/openapi-v2-files-audit.json

@@ -2744,7 +2744,7 @@
       "put": {
         "operationId": "updateFileContent",
         "summary": "Replace File Content",
-        "description": "Replace the complete contents of an existing file from UTF-8 or base64 input.\n\nOAuth scope: `api:write`.",
+        "description": "Replace the complete contents of an existing file from UTF-8 or base64 input. A stale `expectedRevision`, or a write that raced this one, returns `409`; re-read before retrying.\n\nOAuth scope: `api:write`.",
         "x-sim-operation": "files.update_content",
         "x-oauth-scope": "api:write",
         "tags": ["Files"],
@@ -2808,6 +2808,9 @@
           "404": {
             "$ref": "#/components/responses/NotFound"
           },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
           "413": {
             "$ref": "#/components/responses/PayloadTooLarge"
           },

apps/sim/lib/api/contracts/v2/openapi/files-audit.ts

@@ -1168,8 +1168,9 @@ const declaredRoutes = [
       applicationOperation: fileOperations.updateContent,
       operationId: 'updateFileContent',
       summary: 'Replace File Content',
-      description: 'Replace the complete contents of an existing file from UTF-8 or base64 input.',
-      errors: [...RESOURCE_ERRORS, 'PayloadTooLarge'],
+      description:
+        'Replace the complete contents of an existing file from UTF-8 or base64 input. A stale `expectedRevision`, or a write that raced this one, returns `409`; re-read before retrying.',
+      errors: [...RESOURCE_CONFLICT_ERRORS, 'PayloadTooLarge'],
       success: { description: 'The updated file.' },
     }),
     {

apps/sim/lib/api/mcp/generated/v2-operations.ts

@@ -2094,7 +2094,7 @@ export const V2_MCP_OPERATIONS = {
     contract: v2UpdateFileContentContract,
     summary: 'Replace File Content',
     description:
-      'Replace the complete contents of an existing file from UTF-8 or base64 input.\n\nOAuth scope: `api:write`.',
+      'Replace the complete contents of an existing file from UTF-8 or base64 input. A stale `expectedRevision`, or a write that raced this one, returns `409`; re-read before retrying.\n\nOAuth scope: `api:write`.',
     handler: () => import('@/app/api/v2/files/[fileId]/content/route').then((route) => route.PUT),
   },
   updateKnowledgeBase: {