---
{
  "id": "platform.sheet.overview",
  "topic": "sheet",
  "title": "Sheet and workbook overview",
  "locale": "en",
  "version": "2026-08-25",
  "summary": "Twenty-two Sheet Actions cover private workbooks, File Center import, ordered tabs, cells, lifecycle, export, and durable history.",
  "content": "In Sheet, a workbook contains ordered sheets; each sheet tab contains cells. Its 22 registry Actions cover workbook/tab creation, File Center import, discovery, bounded reads, atomic tab/cell batches (`apply_workbook_changes`), individual writes, workbook lifecycle/export, and private history. `create_workbook` creates an initial `Sheet1`, and its initial name is limited to 500 characters. Sheet tab names and later workbook renames accept 1–255 characters. A dry-run never mutates.\n\nBegin with `get_workbook_summary` instead of writing blindly. It returns the current integer `version`, ordered sheets, each `usedRange`, and optionally up to 20 preview rows. When `workbookId` is omitted, an explicit `conversationId` or the current conversation resolves the triggering user’s per-conversation selected workbook. If none is selected, runtime returns `resource_not_found: no workbook selected for this conversation`; call `list_workbooks` and let the user choose, or supply `workbookId`. With `conversationId`, every list item reports `isSelectedForConversation`.\n\n`import_workbook` creates a new workbook from an authorized File Center xlsx, xls, or csv file. `import_into_workbook` replaces an existing workbook, requires `baseVersion` plus UserConfirm, and rejects stale versions. `create_sheet` adds a blank 100-by-26 tab, up to 50 per workbook; `rename_sheet` changes its name. Both require the current `baseVersion`, write access, and a unique non-empty name. Actions cannot insert/delete rows or columns, format, sort, filter, manage permissions, or change conversation preferences. Permanent `delete_workbook` requires the workbook to be archived and requires UserConfirm. Export writes to personal File Center. All Sheet Actions are private. Registry policy and runtime results override this card.\n",
  "aliases": [
    "sheet",
    "spreadsheet",
    "workbook",
    "worksheet",
    "cells",
    "table data",
    "試算表",
    "工作表",
    "活頁簿",
    "儲存格"
  ],
  "tags": [
    "sheet",
    "workbook",
    "overview",
    "routing"
  ],
  "relatedActions": [
    "arinova.sheet.create_workbook",
    "arinova.sheet.import_workbook",
    "arinova.sheet.import_into_workbook",
    "arinova.sheet.apply_workbook_changes",
    "arinova.sheet.create_sheet",
    "arinova.sheet.rename_sheet",
    "arinova.sheet.list_workbooks",
    "arinova.sheet.list_sheets",
    "arinova.sheet.get_workbook_summary",
    "arinova.sheet.read_range",
    "arinova.sheet.update_cells",
    "arinova.sheet.append_rows",
    "arinova.sheet.rename_workbook",
    "arinova.sheet.archive_workbook",
    "arinova.sheet.unarchive_workbook",
    "arinova.sheet.delete_workbook",
    "arinova.sheet.export_workbook",
    "arinova.sheet.list_versions",
    "arinova.sheet.get_version",
    "arinova.sheet.create_named_version",
    "arinova.sheet.restore_version",
    "arinova.sheet.copy_version"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/en/kb/sheet/overview/"
}
---

In Sheet, a workbook contains ordered sheets; each sheet tab contains cells. Its 22 registry Actions cover workbook/tab creation, File Center import, discovery, bounded reads, atomic tab/cell batches (`apply_workbook_changes`), individual writes, workbook lifecycle/export, and private history. `create_workbook` creates an initial `Sheet1`, and its initial name is limited to 500 characters. Sheet tab names and later workbook renames accept 1–255 characters. A dry-run never mutates.

Begin with `get_workbook_summary` instead of writing blindly. It returns the current integer `version`, ordered sheets, each `usedRange`, and optionally up to 20 preview rows. When `workbookId` is omitted, an explicit `conversationId` or the current conversation resolves the triggering user’s per-conversation selected workbook. If none is selected, runtime returns `resource_not_found: no workbook selected for this conversation`; call `list_workbooks` and let the user choose, or supply `workbookId`. With `conversationId`, every list item reports `isSelectedForConversation`.

`import_workbook` creates a new workbook from an authorized File Center xlsx, xls, or csv file. `import_into_workbook` replaces an existing workbook, requires `baseVersion` plus UserConfirm, and rejects stale versions. `create_sheet` adds a blank 100-by-26 tab, up to 50 per workbook; `rename_sheet` changes its name. Both require the current `baseVersion`, write access, and a unique non-empty name. Actions cannot insert/delete rows or columns, format, sort, filter, manage permissions, or change conversation preferences. Permanent `delete_workbook` requires the workbook to be archived and requires UserConfirm. Export writes to personal File Center. All Sheet Actions are private. Registry policy and runtime results override this card.