Introduction to Documents
Beta stability
The Document APIs are still in development and might have breaking changes.
Every request in this guide requires the EARLY-ACCESS: true header. Beta operations are served from the same /api/v3 base path as stable ones, and are unavailable without it.
To learn more, visit the Stability Guidelines and follow the Changelog for updates.
Deprecation notices
- We have deprecated the entry model’s
sectionsfield and will remove it September 1, 2026. To access an entry’s document content, use the parts listing endpoint instead. - We have deprecated the entry update
contentfield and will remove it September 15, 2026. To insert entry document content, use thepartsMutationrequest field.
All Benchling document types in the V3 API share a common content model. Reading and editing content works the same way across them. The currently supported document type is:
- Entry
A document’s content is a flat ordered list of document parts. Each part has a stable identifier and content attributes. Content types include text, headers, list items, unstructured tables, attachments, and more.
Reading document content
Each document type exposes a paginated parts listing as a nested resource. For example:
The endpoint returns parts in document order. For some content such as tables, the response includes a summary. Query the dedicated document part endpoint to retrieve full data for that part. For example:
These root-level document part resources retrieve individual parts directly.
Editing document content
Each document type exposes an update endpoint that accepts content edits. For example:
Submit edits with the partsMutation field when updating a document.
The API supports the operation types insert, move, and delete for document parts, and insert_table_rows and update_table_cells for tables. Insert and move positions can be absolute (beginning_of_document or end_of_document) or relative to a document part ID.
Each API request that mutates the document content must provide the current version ID of the document. If the document changed after you last read it, the API rejects the edit. It doesn’t silently overwrite changes.