Skip to main content
Write content to a file in a connected external storage provider. Creates a new file or updates an existing one. Useful for saving generated reports or documents back to the user’s external storage.

​
Tool details

FieldValue
Namewrite_external_file
GroupExternal Storage

​
Playground

​
Input schema

Input schema
{
  "type": "object",
  "properties": {
    "project_reference": {
      "type": "string",
      "description": "Project ID or slug"
    },
    "provider": {
      "type": "string",
      "description": "Cloud provider name"
    },
    "parent_id": {
      "type": "string",
      "description": "Parent folder ID (use \"root\" for root folder, or get ID from list_external_files)"
    },
    "filename": {
      "type": "string",
      "description": "File name (e.g., \"report.md\")"
    },
    "content": {
      "type": "string",
      "description": "Text content to write"
    },
    "mime_type": {
      "type": "string",
      "description": "MIME type (default: text/plain)"
    }
  },
  "required": [
    "project_reference",
    "provider",
    "parent_id",
    "filename",
    "content"
  ],
  "additionalProperties": false,
  "description": "Input schema for the write_external_file tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

​
Output schema

Output schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Agent-readable status message or rendered content for the external storage operation."
    }
  },
  "required": [
    "message"
  ],
  "additionalProperties": false,
  "description": "Structured result returned by the write_external_file tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}