Sign in
spreadsheets

Save Spreadsheet Body

Save a new version of the body, guarded by expected_version.

put/api/v1/spreadsheets/{spreadsheet_id}/body

Path parameters

spreadsheet_idstring uuid required

Request body

expected_versioninteger required

Response

Successful Response

idstring uuid required
titlestring required
state'streaming' | 'draft' | 'edited' | 'approved' | 'sent' | 'archived' required
kind'report' | 'document' | 'table' | 'spreadsheet' | 'visualization' required

What a document IS, derived from its body — never declared by an author.

Orthogonal to :class:ArtifactType, which says which product surface owns the row. For a document the kind says whether it reads as a written report, plain prose, a single table or a single chart, and :func:app.artifacts.public.doc_body.classify_doc_kind is the only thing that decides.

spreadsheet is reserved for a real spreadsheet artifact (sheets, cells, formulas — PLAN-spreadsheet-artifact.md). A Doc that is one table is a table: two different things must not share one name in the gallery.

folder_idstring uuid nullable required
conversation_idstring uuid nullable required
version_numberinteger required
last_author'agent' | 'user' required
last_author_user_idstring uuid nullable required
created_by_user_idstring uuid nullable required
published_versioninteger nullable required
preview_textstring required
created_atstring date-time required
updated_atstring date-time required
sourcesobject required

Changes