spreadsheet_file_update
Edit a spreadsheet file's metadata — title, tags, folder_id, or the AI-analysis fields — without touching the underlying R2 object. r2_key and source are birth facts: including either field in the call at all, even set to its current value, is refused — re-upload as a new file to change custody or provenance. Moving folder_id re-verifies the target folder belongs to your tenant. NEXT: spreadsheet_file_read to confirm the change landed.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The spreadsheet_file id (spreadsheet_file_list shows them). | |
| tags | No | ||
| title | No | ||
| r2_key | No | ||
| source | No | ||
| ai_prompt | No | ||
| file_size | No | ||
| folder_id | No | ||
| row_count | No | ||
| deleted_at | No | ||
| sheet_count | No | ||
| sheet_names | No | ||
| column_count | No | ||
| analysis_summary | No | ||
| last_analyzed_at | No | ||
| original_filename | No | ||
| expected_updated_at | No | Optional compare-and-set guard: the updated_at you last read. Mismatch returns CONFLICT with the current value. |