> This page is for Developer Documentation.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.benchling.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.benchling.com/_mcp/server.

# List DocumentPart items

GET https://{tenant_name}.benchling.com/api/v3/entry/{entry_id}/parts/items

List DocumentPart items.

Reference: https://docs.benchling.com/docs/api/benchling-api/entry/parts-list

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Path parameters

- `entry_id` (string, required) — ID of the Entry.

### Query parameters

- `id.anyOf` (string, optional) — Restricts results to those matching any of the specified IDs. Comma-separated list.
- `modifiedAt.gt` (string, optional) — Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those modified after the specified time. e.g. > 2017-04-30.
- `modifiedAt.gte` (string, optional) — Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those modified at or after the specified time. e.g. >= 2017-04-30.
- `modifiedAt.lt` (string, optional) — Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those modified before the specified time. e.g. \< 2017-04-30.
- `modifiedAt.lte` (string, optional) — Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those modified at or before the specified time. e.g. \<= 2017-04-30.
- `nextToken` (string, optional) — Token for pagination
- `pageSize` (integer, optional) — Number of results to return. Defaults to 50, maximum of 100.
- `sort` (enum, optional, default: modifiedAt:desc) — Method by which to order results. Valid sorts are: modifiedAt (modified time, oldest first). Use :asc or :desc to specify ascending or descending order. Default is modifiedAt:desc.
  - Allowed values: `modifiedAt:asc`, `modifiedAt:desc`

### Headers

- `EARLY-ACCESS` (string, optional) — Set to true to access beta operations via /api/v3.

## Response

### 200

OK

- `items` (list of DocumentPart, optional)
- `nextToken` (string, optional)

## Errors

### 400 Entry Parts List Request Bad Request Error

Bad Request

- `detail` (GeneralErrorDetail, required, nullable)
- `instance` (string, required)
- `status` (integer, required)
- `title` (string, required, nullable)
- `type` (string, required)
- `invalidId` (string, optional)

### 403 Entry Parts List Request Forbidden Error

Forbidden

- `detail` (GeneralErrorDetail, required, nullable)
- `instance` (string, required)
- `status` (integer, required)
- `title` (string, required, nullable)
- `type` (string, required)
- `invalidId` (string, optional)

### 404 Entry Parts List Request Not Found Error

Not Found

- `detail` (GeneralErrorDetail, required, nullable)
- `instance` (string, required)
- `status` (integer, required)
- `title` (string, required, nullable)
- `type` (string, required)
- `invalidId` (string, optional)

### 429 Entry Parts List Request Too Many Requests Error

Too Many Requests

- `detail` (TooManyRequestsErrorBodyDetail, required, nullable)
- `instance` (string, required)
- `status` (integer, required)
- `title` (string, required, nullable)
- `type` (string, required)
- `invalidId` (string, optional)
- `violated-policies` (list of enum, optional) — The budget policies that rejected the request, in canonical order: `user`, `integration`, then `tenant`.
  - Allowed values: `user`, `integration`, `tenant`

### 500 Entry Parts List Request Internal Server Error

Internal Server Error

- `detail` (InternalServerErrorBodyDetail, required, nullable)
- `instance` (string, required)
- `status` (integer, required)
- `title` (string, required, nullable)
- `type` (string, required)
- `errorId` (string, optional)

## Types

### DocumentPart

### GeneralErrorDetail

### TooManyRequestsErrorBodyDetail

### InternalServerErrorBodyDetail

### DocumentPartAnalysis

Represents an analysis embedded in a document, created from an analysis template. The template is applied asynchronously after the part is created, so the analysis may not yet be populated when first read.

- `__typename` (string, optional)
- `analysis` (AnalysisRef, optional, nullable) — Specifies the embedded analysis. Null when the analysis reference has been cleared (such as in content copied from another document), when the referenced analysis no longer exists, or when the requester cannot access it.
- `analysisTemplate` (AutomationTemplateRef, optional, nullable) — Specifies the analysis template the analysis was created from. Null when the template reference has been cleared (such as in content copied from another document), when the referenced template no longer exists, or when the requester cannot access it.
- `createdAt` (string, optional) — Timestamp inherited from the document content backing this part. For entry and document content, this can reflect when the containing document was created, not when the DocumentPart identifier was created.
- `id` (string, optional) — Identifies the document part.
- `indentation` (integer, optional) — Specifies the indentation level for this content within the document.
- `modifiedAt` (string, optional) — Specifies when this document part was last modified.
- `modifier` (PrincipalRef, optional, nullable) — Identifies who last modified this document part.
- `versionMetadata` (DocumentLikeVersionMetadata, optional) — Specifies version metadata for the parent document.

### DocumentPartAttachment

Represents an attachment within a document. Attachments store file metadata and provide a time-limited download URL when allowed by antivirus policy.

- `__typename` (string, optional)
- `caption` (Caption, optional, nullable) — Specifies the rich text caption displayed with the attachment. Null if the attachment has no caption.
- `createdAt` (string, optional) — Timestamp inherited from the document content backing this part. For entry and document content, this can reflect when the containing document was created, not when the DocumentPart identifier was created.
- `customWidth` (integer, optional, nullable) — Specifies the custom display width in pixels, when set.
- `download` (DocumentAttachmentDownload, optional, nullable) — Provides a time-limited download for the attachment. Null if the attachment is blocked by antivirus scanning.
- `externalFileId` (string, optional) — Identifies the external file record for this attachment.
- `filename` (string, optional) — Specifies the attachment filename.
- `id` (string, optional) — Identifies the document part.
- `indentation` (integer, optional) — Specifies the indentation level for this content within the document.
- `modifiedAt` (string, optional) — Specifies when this document part was last modified.
- `modifier` (PrincipalRef, optional, nullable) — Identifies who last modified this document part.
- `scanStatus` (enum, optional) — Specifies the current antivirus scan status of the attachment. Download availability is determined by whether download is null.
  - Allowed values: `PENDING`, `NO_THREATS_FOUND`, `THREATS_FOUND`, `UNSUPPORTED`, `ACCESS_DENIED`, `FAILED`, `NEVER_SCANNED`
- `size` (integer, optional) — Specifies the attachment size in bytes.
- `versionMetadata` (DocumentLikeVersionMetadata, optional) — Specifies version metadata for the parent document.

### DocumentPartAttachmentPlaceholder

Represents a reserved attachment slot within a document. Placeholders do not reference an uploaded file yet.

- `__typename` (string, optional)
- `createdAt` (string, optional) — Timestamp inherited from the document content backing this part. For entry and document content, this can reflect when the containing document was created, not when the DocumentPart identifier was created.
- `customWidth` (integer, optional, nullable) — Specifies the custom display width in pixels, when set.
- `id` (string, optional) — Identifies the document part.
- `indentation` (integer, optional) — Specifies the indentation level for this content within the document.
- `modifiedAt` (string, optional) — Specifies when this document part was last modified.
- `modifier` (PrincipalRef, optional, nullable) — Identifies who last modified this document part.
- `versionMetadata` (DocumentLikeVersionMetadata, optional) — Specifies version metadata for the parent document.

### DocumentPartBenchlingItem

Represents an embedded reference to another Benchling item within a document. Supported items include sequences, AA sequences, custom entities, oligo conjugates and duplexes, proteins, entries, protocols, and other basic folder items.

- `__typename` (string, optional)
- `createdAt` (string, optional) — Timestamp inherited from the document content backing this part. For entry and document content, this can reflect when the containing document was created, not when the DocumentPart identifier was created.
- `embeddedItem` (DocumentEmbeddable, optional, nullable) — Specifies the embedded item with its identifier and type. The type determines which API resource returns the full item. Items not available via the API include only the identifier and cannot be fetched.
- `id` (string, optional) — Identifies the document part.
- `indentation` (integer, optional) — Specifies the indentation level for this content within the document.
- `modifiedAt` (string, optional) — Specifies when this document part was last modified.
- `modifier` (PrincipalRef, optional, nullable) — Identifies who last modified this document part.
- `versionMetadata` (DocumentLikeVersionMetadata, optional) — Specifies version metadata for the parent document.

### DocumentPartCodeBlock

Represents a code block within a document. Content is stored as plain text and displayed in a fixed-width format.

- `__typename` (string, optional)
- `createdAt` (string, optional) — Timestamp inherited from the document content backing this part. For entry and document content, this can reflect when the containing document was created, not when the DocumentPart identifier was created.
- `id` (string, optional) — Identifies the document part.
- `modifiedAt` (string, optional) — Specifies when this document part was last modified.
- `modifier` (PrincipalRef, optional, nullable) — Identifies who last modified this document part.
- `text` (string, optional) — Specifies the plain-text body.
- `versionMetadata` (DocumentLikeVersionMetadata, optional) — Specifies version metadata for the parent document.

### DocumentPartHeader

Represents a heading within a document. Headings organize content by level and may include rich text and indentation.

- `__typename` (string, optional)
- `createdAt` (string, optional) — Timestamp inherited from the document content backing this part. For entry and document content, this can reflect when the containing document was created, not when the DocumentPart identifier was created.
- `formats` (list of TextFormat, optional) — Lists inline styling applied to character ranges in the plain-text body.
- `headerType` (enum, optional) — Specifies the heading level and style: level one, level two, or subheader.
  - Allowed values: `HEADER_1`, `HEADER_2`, `SUBHEADER_1`
- `id` (string, optional) — Identifies the document part.
- `indentation` (integer, optional) — Specifies the indentation level for this content within the document.
- `links` (list of LinkSpan, optional) — Lists hyperlinks applied to character ranges in the plain-text body.
- `mentions` (list of Mention, optional) — Lists inline mentions of other Benchling items in the plain-text body.
- `modifiedAt` (string, optional) — Specifies when this document part was last modified.
- `modifier` (PrincipalRef, optional, nullable) — Identifies who last modified this document part.
- `text` (string, optional) — Specifies the plain-text body. Character indices in formats, links, and mentions refer to positions in this string.
- `versionMetadata` (DocumentLikeVersionMetadata, optional) — Specifies version metadata for the parent document.

### DocumentPartImageGrid

Represents an ordered grid of image attachments within a document. The grid controls indentation. Each image omits indentation.

- `__typename` (string, optional)
- `createdAt` (string, optional) — Timestamp inherited from the document content backing this part. For entry and document content, this can reflect when the containing document was created, not when the DocumentPart identifier was created.
- `id` (string, optional) — Identifies the document part.
- `images` (list of ImageGridAttachment, optional) — Lists the image attachments in display order.
- `indentation` (integer, optional) — Specifies the indentation level for this content within the document.
- `modifiedAt` (string, optional) — Specifies when this document part was last modified.
- `modifier` (PrincipalRef, optional, nullable) — Identifies who last modified this document part.
- `name` (string, optional) — Specifies the display name of the image grid.
- `versionMetadata` (DocumentLikeVersionMetadata, optional) — Specifies version metadata for the parent document.

### DocumentPartListItem

Represents a single list item within a document. List items combine a marker style with rich text and indentation for ordered, unordered, and checklist content.

- `__typename` (string, optional)
- `createdAt` (string, optional) — Timestamp inherited from the document content backing this part. For entry and document content, this can reflect when the containing document was created, not when the DocumentPart identifier was created.
- `formats` (list of TextFormat, optional) — Lists inline styling applied to character ranges in the plain-text body.
- `id` (string, optional) — Identifies the document part.
- `indentation` (integer, optional) — Specifies the indentation level for this content within the document.
- `links` (list of LinkSpan, optional) — Lists hyperlinks applied to character ranges in the plain-text body.
- `listType` (enum, optional) — Specifies the list marker style.
  - Allowed values: `BULLET`, `NUMBER`, `CHECKBOX_CHECKED`, `CHECKBOX_UNCHECKED`
- `mentions` (list of Mention, optional) — Lists inline mentions of other Benchling items in the plain-text body.
- `modifiedAt` (string, optional) — Specifies when this document part was last modified.
- `modifier` (PrincipalRef, optional, nullable) — Identifies who last modified this document part.
- `text` (string, optional) — Specifies the plain-text body. Character indices in formats, links, and mentions refer to positions in this string.
- `versionMetadata` (DocumentLikeVersionMetadata, optional) — Specifies version metadata for the parent document.

### DocumentPartResultsTable

A results structured table promoted to a first-class, individually-fetchable document part. Captures experimental data against a result schema and supports row submission workflows.

- `__typename` (string, optional)
- `columnDefinitions` (list of IStructuredTableColumnDefinition, optional)
- `createdAt` (string, optional)
- `id` (string, optional)
- `indentation` (integer, optional)
- `isEvaluated` (boolean, optional)
- `isSubmittable` (boolean, optional)
- `modifiedAt` (string, optional)
- `modifier` (PrincipalRef, optional, nullable)
- `name` (string, optional)
- `resultSchema` (ResultSchemaRef, optional, nullable)
- `rowCount` (integer, optional)
- `rows` (string, optional)
- `submissionStatus` (enum, optional)
  - Allowed values: `UNSUBMITTED`, `SUBMITTED`, `HAS_UNSUBMITTED_CHANGES`, `UNEVALUATED`
- `versionMetadata` (DocumentLikeVersionMetadata, optional) — Version metadata for a document such as an entry, template, or subtemplate. Identifies a specific content revision and records when that revision was produced. Use this to detect changes, pin a revision, or reference a particular version without loading the full version record.

### DocumentPartRun

Represents an embedded reference to a laboratory automation run schema and, when present, its run instance.

- `__typename` (string, optional)
- `createdAt` (string, optional) — Timestamp inherited from the document content backing this part. For entry and document content, this can reflect when the containing document was created, not when the DocumentPart identifier was created.
- `id` (string, optional) — Identifies the document part.
- `indentation` (integer, optional) — Specifies the indentation level for this content within the document.
- `modifiedAt` (string, optional) — Specifies when this document part was last modified.
- `modifier` (PrincipalRef, optional, nullable) — Identifies who last modified this document part.
- `run` (RunRef, optional, nullable) — Specifies the linked run instance, when one exists.
- `runSchema` (RunSchemaRef, optional) — Specifies the run schema associated with this content.
- `versionMetadata` (DocumentLikeVersionMetadata, optional) — Specifies version metadata for the parent document.

### DocumentPartSection

Represents a section that groups related document content within a document.

- `__typename` (string, optional)
- `color` (enum, optional, nullable) — Specifies the highlight color for the section, when set.
  - Allowed values: `DEFAULT`, `RED`, `ORANGE`, `YELLOW`, `GREEN`, `BLUE`, `INDIGO`, `VIOLET`, `CONTRAST_GREY`, `CONTRAST_RED`, `CONTRAST_ORANGE`, `CONTRAST_YELLOW`, `CONTRAST_GREEN`, `CONTRAST_BLUE`, `CONTRAST_INDIGO`, `CONTRAST_VIOLET`
- `createdAt` (string, optional) — Timestamp inherited from the document content backing this part. For entry and document content, this can reflect when the containing document was created, not when the DocumentPart identifier was created.
- `date` (date, optional, nullable) — Specifies the section date, when set.
- `id` (string, optional) — Identifies the document part.
- `modifiedAt` (string, optional) — Specifies when this document part was last modified.
- `modifier` (PrincipalRef, optional, nullable) — Identifies who last modified this document part.
- `title` (string, optional, nullable) — Specifies the section title, when set.
- `versionMetadata` (DocumentLikeVersionMetadata, optional) — Specifies version metadata for the parent document.

### DocumentPartText

Represents a paragraph of rich text within a document. Text may include inline styling, hyperlinks, and mentions of other Benchling items.

- `__typename` (string, optional)
- `createdAt` (string, optional) — Timestamp inherited from the document content backing this part. For entry and document content, this can reflect when the containing document was created, not when the DocumentPart identifier was created.
- `formats` (list of TextFormat, optional) — Lists inline styling applied to character ranges in the plain-text body.
- `id` (string, optional) — Identifies the document part.
- `indentation` (integer, optional) — Specifies the indentation level for this content within the document.
- `links` (list of LinkSpan, optional) — Lists hyperlinks applied to character ranges in the plain-text body.
- `mentions` (list of Mention, optional) — Lists inline mentions of other Benchling items in the plain-text body.
- `modifiedAt` (string, optional) — Specifies when this document part was last modified.
- `modifier` (PrincipalRef, optional, nullable) — Identifies who last modified this document part.
- `text` (string, optional) — Specifies the plain-text body. Character indices in formats, links, and mentions refer to positions in this string.
- `versionMetadata` (DocumentLikeVersionMetadata, optional) — Specifies version metadata for the parent document.

### DocumentPartTextBox

Represents a labeled fill-in text box within a document. Values may be submitted.

- `__typename` (string, optional)
- `createdAt` (string, optional) — Timestamp inherited from the document content backing this part. For entry and document content, this can reflect when the containing document was created, not when the DocumentPart identifier was created.
- `formats` (list of TextFormat, optional) — Lists inline styling applied to character ranges in the plain-text body.
- `id` (string, optional) — Identifies the document part.
- `indentation` (integer, optional) — Specifies the indentation level for this content within the document.
- `isSubmittable` (boolean, optional) — Specifies whether this content can be submitted in its current state.
- `links` (list of LinkSpan, optional) — Lists hyperlinks applied to character ranges in the plain-text body.
- `mentions` (list of Mention, optional) — Lists inline mentions of other Benchling items in the plain-text body.
- `modifiedAt` (string, optional) — Specifies when this document part was last modified.
- `modifier` (PrincipalRef, optional, nullable) — Identifies who last modified this document part.
- `name` (string, optional) — Specifies the display label for the text box.
- `submissionStatus` (enum, optional) — Specifies the submission status of this content: unsubmitted, submitted, or has unsubmitted changes.
  - Allowed values: `UNSUBMITTED`, `SUBMITTED`, `HAS_UNSUBMITTED_CHANGES`, `UNEVALUATED`
- `text` (string, optional) — Specifies the plain-text body. Character indices in formats, links, and mentions refer to positions in this string.
- `versionMetadata` (DocumentLikeVersionMetadata, optional) — Specifies version metadata for the parent document.

### DocumentPartUnavailable

Represents a document part whose specific type is not yet available in the API at the requested stability. Only the fields shared by all document parts are returned.

- `__typename` (string, optional)
- `createdAt` (string, optional) — Timestamp inherited from the document content backing this part. For entry and document content, this can reflect when the containing document was created, not when the DocumentPart identifier was created.
- `id` (string, optional) — Identifies the document part.
- `modifiedAt` (string, optional) — Specifies when this document part was last modified.
- `modifier` (PrincipalRef, optional, nullable) — Identifies who last modified this document part.
- `versionMetadata` (DocumentLikeVersionMetadata, optional) — Specifies version metadata for the parent document.

### DocumentPartUnstructuredTable

Represents an unstructured table embedded within a notebook entry or other document. Unstructured tables use freeform cells without schema-backed columns. Cells may contain text, formulas with evaluated values, formatting, and merged regions. This summary representation excludes row data.

- `__typename` (string, optional)
- `caption` (Caption, optional, nullable) — Specifies the rich text caption displayed with the table. Null if the table has no caption.
- `columnDefinitions` (list of TableColumnDefinition, optional) — Lists column definitions for the table.
- `createdAt` (string, optional) — Timestamp inherited from the document content backing this part. For entry and document content, this can reflect when the containing document was created, not when the DocumentPart identifier was created.
- `id` (string, optional) — Identifies the document part.
- `indentation` (integer, optional) — Specifies the indentation level for this content within the document.
- `isEvaluated` (boolean, optional) — Specifies whether formula evaluation has been applied to the table.
- `modifiedAt` (string, optional) — Specifies when this document part was last modified.
- `modifier` (PrincipalRef, optional, nullable) — Identifies who last modified this document part.
- `name` (string, optional) — Specifies the display name of the table.
- `rowCount` (integer, optional) — Specifies the number of rows in the table.
- `versionMetadata` (DocumentLikeVersionMetadata, optional) — Specifies version metadata for the parent document.

### DocumentPartUnstructuredTableDetail

Represents an unstructured table embedded within a notebook entry or other document, including row and cell data. Returned when a request's returning spec asks for the detail type.

- `__typename` (string, optional)
- `caption` (Caption, optional, nullable) — Specifies the rich text caption displayed with the table. Null if the table has no caption.
- `columnDefinitions` (list of TableColumnDefinition, optional) — Lists column definitions for the table.
- `createdAt` (string, optional) — Timestamp inherited from the document content backing this part. For entry and document content, this can reflect when the containing document was created, not when the DocumentPart identifier was created.
- `id` (string, optional) — Identifies the document part.
- `indentation` (integer, optional) — Specifies the indentation level for this content within the document.
- `isEvaluated` (boolean, optional) — Specifies whether formula evaluation has been applied to the table.
- `modifiedAt` (string, optional) — Specifies when this document part was last modified.
- `modifier` (PrincipalRef, optional, nullable) — Identifies who last modified this document part.
- `name` (string, optional) — Specifies the display name of the table.
- `rowCount` (integer, optional) — Specifies the number of rows in the table.
- `rows` (list of TableRow, optional) — Lists rows in the table, each containing an ordered array of cells.
- `versionMetadata` (DocumentLikeVersionMetadata, optional) — Specifies version metadata for the parent document.

### AnalysisRef

- `__typename` (string, optional)
- `id` (string, optional)

### AutomationTemplateRef

- `__typename` (string, optional)
- `id` (string, optional)

### PrincipalRef

- `__typename` (string, optional)
- `id` (string, optional)

### DocumentLikeVersionMetadata

Version metadata for a document such as an entry, template, or subtemplate. Identifies a specific content revision and records when that revision was produced. Use this to detect changes, pin a revision, or reference a particular version without loading the full version record.

- `__typename` (string, optional)
- `createdAt` (string, optional, nullable) — Specifies when this version was created. Versions are immutable; this is the time the parent document was last edited to produce this revision.
- `versionId` (string, optional) — Identifies this version of the document.

### Caption

A rich text caption attached to a piece of document content, such as a table or an attachment.

- `__typename` (string, optional)
- `formats` (list of TextFormat, optional)
- `links` (list of LinkSpan, optional)
- `mentions` (list of Mention, optional)
- `text` (string, optional)

### DocumentAttachmentDownload

Provides a time-limited URL for downloading a document attachment.

- `__typename` (string, optional)
- `expiresAt` (string, optional) — Specifies when the download URL expires, in ISO 8601 format.
- `url` (string, optional) — Specifies the presigned URL to download the attachment.

### DocumentEmbeddable

### TextFormat

Specifies inline styling applied to a character range within rich text.

- `__typename` (string, optional)
- `backgroundColor` (string, optional, nullable) — Specifies the background color applied to the character range, when set.
- `end` (integer, optional) — Specifies the exclusive end index of the character range within the plain-text body.
- `foregroundColor` (string, optional, nullable) — Specifies the text color applied to the character range, when set.
- `properties` (list of enum, optional) — Specifies the character style properties applied to the range: bold, italic, underline, strikethrough, subscript, superscript, and monospace.
  - Allowed values: `BOLD`, `ITALIC`, `UNDERLINE`, `STRIKETHROUGH`, `SUBSCRIPT`, `SUPERSCRIPT`, `MONOSPACE`
- `start` (integer, optional) — Specifies the inclusive start index of the character range within the plain-text body.

### LinkSpan

Specifies a hyperlink applied to a character range within rich text content.

- `__typename` (string, optional)
- `end` (integer, optional) — Specifies the exclusive end index of the character range within the plain-text body.
- `start` (integer, optional) — Specifies the inclusive start index of the character range within the plain-text body.
- `url` (string, optional) — Specifies the URL of the hyperlink.

### Mention

Represents an inline mention of another Benchling item within text content.

- `__typename` (string, optional)
- `itemId` (string, optional) — Identifies the referenced Benchling item.
- `position` (integer, optional) — Specifies the zero-based insertion index within the plain-text body where this mention appears. Mentions do not occupy characters in the plain-text body for purposes of format range start and end positions.

### ImageGridAttachment

Represents an image attachment nested within an image grid. The containing grid controls indentation.

- `__typename` (string, optional)
- `caption` (Caption, optional, nullable) — Specifies the rich text caption displayed with the image. Null if the image has no caption.
- `customWidth` (integer, optional, nullable) — Specifies the custom display width in pixels, when set.
- `download` (DocumentAttachmentDownload, optional, nullable) — Provides a time-limited download for the attachment. Null if the attachment is blocked by antivirus scanning.
- `externalFileId` (string, optional) — Identifies the external file record for this attachment.
- `filename` (string, optional) — Specifies the attachment filename.
- `scanStatus` (enum, optional) — Specifies the current antivirus scan status of the attachment. Download availability is determined by whether download is null.
  - Allowed values: `PENDING`, `NO_THREATS_FOUND`, `THREATS_FOUND`, `UNSUPPORTED`, `ACCESS_DENIED`, `FAILED`, `NEVER_SCANNED`
- `size` (integer, optional) — Specifies the attachment size in bytes.

### IStructuredTableColumnDefinition

### ResultSchemaRef

- `__typename` (string, optional)
- `id` (string, optional)

### RunRef

- `__typename` (string, optional)
- `id` (string, optional)

### RunSchemaRef

- `__typename` (string, optional)
- `id` (string, optional)

### TableColumnDefinition

Specifies a column definition within an unstructured table.

- `__typename` (string, optional)
- `isLocked` (boolean, optional) — Specifies whether the column width is locked against resizing.
- `name` (string, optional) — Specifies the column display name.
- `width` (double, optional, nullable) — Specifies the column width in pixels. Defaults to 100 when unset.

### TableRow

Specifies a row within an unstructured table.

- `__typename` (string, optional)
- `cells` (list of TableCell, optional) — Lists cells in the row in column order.
- `rowIndex` (integer, optional) — Specifies the row's absolute position within the table, zero-based.

### AaSequence

- `__typename` (string, optional)
- `authors` (string, optional, nullable)
- `creator` (PrincipalRef, optional, nullable)
- `schemaFields` (list of SchemaFieldValue, optional, nullable)
- `aliases` (list of string, optional, nullable) — Array of aliases
- `aminoAcids` (string, optional) — Amino acids of the AA sequence.
- `annotations` (string, optional) — Annotations marking functional regions, domains, binding sites, post-translational modifications, or other features on the AA sequence.
- `archiveReason` (string, optional, nullable)
- `archived` (boolean, optional)
- `createdAt` (string, optional, nullable) — DateTime the AA sequence was created.
- `customFields` (list of CustomField, optional, nullable) — Custom fields set on the AA sequence.
- `entityRegistryId` (string, optional, nullable) — The registry-assigned identifier for this item (e.g. its registry ID shown in the UI), present only once the item has been registered. Null if the item is not registered.
- `folder` (FolderRef, optional, nullable) — Folder containing the AA sequence.
- `id` (string, optional) — ID of the AA sequence.
- `modifiedAt` (string, optional, nullable) — DateTime the AA sequence was last modified.
- `name` (string, optional) — Name of the item.
- `project` (ProjectRef, optional, nullable)
- `registrationOrigin` (RegistrationOrigin, optional, nullable) — Provenance of this item's registration — where and when it was registered. Null if unregistered.
- `registry` (RegistryRef, optional, nullable) — The Registry this item belongs to, if registered. Null if unregistered.
- `schema` (EntitySchemaRef, optional, nullable) — Use typedSchema instead, which returns the per-type schema.
- `typedSchema` (AaSequenceSchemaRef, optional, nullable)

### CustomEntity

- `__typename` (string, optional)
- `authors` (string, optional, nullable)
- `creator` (PrincipalRef, optional, nullable)
- `schemaFields` (list of SchemaFieldValue, optional, nullable)
- `aliases` (list of string, optional, nullable)
- `archiveReason` (string, optional, nullable)
- `archived` (boolean, optional)
- `createdAt` (string, optional, nullable)
- `customFields` (list of CustomField, optional, nullable)
- `entityRegistryId` (string, optional, nullable) — The registry-assigned identifier for this item (e.g. its registry ID shown in the UI), present only once the item has been registered. Null if the item is not registered.
- `folder` (FolderRef, optional, nullable)
- `id` (string, optional)
- `modifiedAt` (string, optional, nullable)
- `name` (string, optional, nullable) — Name of the item.
- `project` (ProjectRef, optional, nullable)
- `registrationOrigin` (RegistrationOrigin, optional, nullable) — Provenance of this item's registration — where and when it was registered. Null if unregistered.
- `registry` (RegistryRef, optional, nullable) — The Registry this item belongs to, if registered. Null if unregistered.
- `schema` (EntitySchemaRef, optional, nullable) — Use typedSchema instead, which returns the per-type schema.
- `typedSchema` (CustomEntitySchemaRef, optional, nullable)

### DnaSequence

- `__typename` (string, optional)
- `authors` (string, optional, nullable)
- `creator` (PrincipalRef, optional, nullable)
- `schemaFields` (list of SchemaFieldValue, optional, nullable)
- `aliases` (list of string, optional, nullable) — Array of aliases
- `annotations` (string, optional) — Annotations on the DNA sequence, not including translations or primers. Annotations on parts are not included.
- `archiveReason` (string, optional, nullable)
- `archived` (boolean, optional)
- `bases` (string, optional) — Bases of the forward strand of the DNA sequence.
- `createdAt` (string, optional, nullable)
- `customFields` (list of CustomField, optional) — Custom fields set on the DNA sequence.
- `entityRegistryId` (string, optional, nullable) — The registry-assigned identifier for this item (e.g. its registry ID shown in the UI), present only once the item has been registered. Null if the item is not registered.
- `folder` (FolderRef, optional, nullable)
- `id` (string, optional)
- `isCircular` (boolean, optional) — Whether the DNA sequence is circular or linear.
- `modifiedAt` (string, optional, nullable)
- `name` (string, optional) — Name of the item.
- `nucleotideAlignments` (string, optional) — Nucleotide alignments that use this sequence as the reference sequence. For template alignments, this is the template sequence; for consensus alignments, this is the derived consensus sequence.
- `parts` (string, optional) — Part features linking regions of this sequence to other nucleotide sequences.
- `primers` (string, optional) — Primer bind features on the DNA sequence. Primers on parts are not included.
- `project` (ProjectRef, optional, nullable)
- `registrationOrigin` (RegistrationOrigin, optional, nullable) — Provenance of this item's registration — where and when it was registered. Null if unregistered.
- `registry` (RegistryRef, optional, nullable) — The Registry this item belongs to, if registered. Null if unregistered.
- `schema` (EntitySchemaRef, optional, nullable) — Use typedSchema instead, which returns the per-type schema.
- `startIndex` (integer, optional) — Starting index for the sequence residues of linear DNA sequences. Implicitly 1 for other sequence types.
- `translations` (string, optional) — Translation annotations present on the DNA sequence. Translations may be one region or split across multiple regions. Translations on parts are not included.
- `typedSchema` (DnaSequenceSchemaRef, optional, nullable)

### Entry

- `__typename` (string, optional)
- `authors` (string, optional, nullable) — Lists the authors of the entry. Defaults to the creator but may be edited.
- `creator` (PrincipalRef, optional, nullable) — Identifies who created the entry.
- `parts` (string, optional) — Lists ordered document parts that make up the document content.
- `schemaFields` (list of SchemaFieldValue, optional, nullable) — Lists values for fields defined by the entry schema.
- `applicableReviewProcesses` (string, optional) — Lists review processes configured for the entry's project. Use the paginated list of applicable review processes for the full list including stages and version details.
- `archiveReason` (string, optional, nullable) — Specifies the archive reason when the entry is archived.
- `archived` (boolean, optional) — Specifies whether the entry is archived.
- `createdAt` (string, optional, nullable) — Specifies when the entry was created.
- `customFields` (list of CustomField, optional, nullable) — Lists custom field values on the entry.
- `displayId` (string, optional, nullable) — Specifies the display ID for the entry.
- `folder` (FolderRef, optional, nullable) — Specifies the folder that contains the entry.
- `id` (string, optional) — Identifies the entry.
- `modifiedAt` (string, optional, nullable) — Specifies when the entry was last modified.
- `name` (string, optional, nullable) — Specifies the title of the entry.
- `review` (ReviewRef, optional, nullable) — Specifies the active review for the entry when one exists. Null when the entry has not been sent for review or the review was retracted.
- `reviewSource` (ProjectRef, optional) — Specifies the project that owns the entry and determines which review processes apply.
- `schema` (EntrySchemaRef, optional, nullable) — Specifies the entry schema when one is configured.
- `sections` (list of EntrySection, optional, nullable)
- `selectors` (list of TableCellSelector, optional) — Lists dropdown selectors available to table cells in the document.
- `typedSchema` (EntrySchemaRef, optional, nullable)
- `versionMetadata` (DocumentLikeVersionMetadata, optional) — Specifies version metadata for the current revision of the entry.

### OligoConjugate

- `__typename` (string, optional)
- `authors` (string, optional, nullable)
- `creator` (PrincipalRef, optional)
- `schemaFields` (list of SchemaFieldValue, optional, nullable)
- `aliases` (list of string, optional, nullable)
- `archiveReason` (string, optional, nullable)
- `archived` (boolean, optional)
- `backbone` (NucleotideSimplePolymer, optional) — Represents a nucleic acid strand (DNA or RNA) within a complex polymer structure. Contains the sequence residues and connections to other polymers. The entity field links to a corresponding DnaSequence, RnaSequence, DnaOligo, or RnaOligo. Used as the backbone component in OligoConjugate and as forward/reverse strands in OligoDuplex.
- `canonicalHelm` (string, optional)
- `conjugates` (list of IOligoConjugateConjugatesItem, optional)
- `createdAt` (string, optional)
- `customFields` (list of CustomField, optional, nullable)
- `entityRegistryId` (string, optional, nullable) — The registry-assigned identifier for this item (e.g. its registry ID shown in the UI), present only once the item has been registered. Null if the item is not registered.
- `folder` (FolderRef, optional, nullable)
- `id` (string, optional)
- `modifiedAt` (string, optional)
- `name` (string, optional) — Name of the item.
- `originalHelm` (string, optional, nullable)
- `outOfSync` (boolean, optional)
- `outOfSyncReason` (string, optional, nullable)
- `project` (ProjectRef, optional, nullable)
- `registrationOrigin` (RegistrationOrigin, optional, nullable) — Provenance of this item's registration — where and when it was registered. Null if unregistered.
- `registry` (RegistryRef, optional, nullable) — The Registry this item belongs to, if registered. Null if unregistered.
- `schema` (EntitySchemaRef, optional) — Use typedSchema instead, which returns the per-type schema.
- `structure` (OligoConjugateStructure, optional) — Contains the complete structural definition of an oligo conjugate, including its oligonucleotide backbone, conjugated molecules and peptides, and the connections between them. For each simple polymer, restricted read access on the linked entity affects `entity` only; structural fields on that polymer are still populated for the containing conjugate.
- `typedSchema` (OligoConjugateSchemaRef, optional)

### OligoDuplex

- `__typename` (string, optional)
- `authors` (string, optional, nullable)
- `creator` (PrincipalRef, optional)
- `schemaFields` (list of SchemaFieldValue, optional, nullable)
- `aliases` (list of string, optional, nullable)
- `archiveReason` (string, optional, nullable)
- `archived` (boolean, optional)
- `canonicalHelm` (string, optional)
- `conjugates` (list of IOligoDuplexConjugatesItem, optional)
- `createdAt` (string, optional)
- `customFields` (list of CustomField, optional, nullable)
- `entityRegistryId` (string, optional, nullable) — The registry-assigned identifier for this item (e.g. its registry ID shown in the UI), present only once the item has been registered. Null if the item is not registered.
- `folder` (FolderRef, optional, nullable)
- `forwardOffset` (integer, optional, nullable)
- `forwardStrand` (NucleotideSimplePolymer, optional) — Represents a nucleic acid strand (DNA or RNA) within a complex polymer structure. Contains the sequence residues and connections to other polymers. The entity field links to a corresponding DnaSequence, RnaSequence, DnaOligo, or RnaOligo. Used as the backbone component in OligoConjugate and as forward/reverse strands in OligoDuplex.
- `id` (string, optional)
- `modifiedAt` (string, optional)
- `name` (string, optional) — Name of the item.
- `originalHelm` (string, optional, nullable)
- `outOfSync` (boolean, optional)
- `outOfSyncReason` (string, optional, nullable)
- `project` (ProjectRef, optional, nullable)
- `registrationOrigin` (RegistrationOrigin, optional, nullable) — Provenance of this item's registration — where and when it was registered. Null if unregistered.
- `registry` (RegistryRef, optional, nullable) — The Registry this item belongs to, if registered. Null if unregistered.
- `reverseStrand` (NucleotideSimplePolymer, optional) — Represents a nucleic acid strand (DNA or RNA) within a complex polymer structure. Contains the sequence residues and connections to other polymers. The entity field links to a corresponding DnaSequence, RnaSequence, DnaOligo, or RnaOligo. Used as the backbone component in OligoConjugate and as forward/reverse strands in OligoDuplex.
- `schema` (EntitySchemaRef, optional) — Use typedSchema instead, which returns the per-type schema.
- `structure` (OligoDuplexStructure, optional) — Contains the complete structural definition of an oligo duplex, including its forward and reverse strands, any conjugated molecules and peptides, and the connections between them. For each simple polymer, restricted read access on the linked entity affects `entity` only; structural fields on that polymer are still populated for the containing duplex.
- `typedSchema` (OligoDuplexSchemaRef, optional)

### Protein

- `__typename` (string, optional)
- `authors` (string, optional, nullable)
- `creator` (PrincipalRef, optional)
- `schemaFields` (list of SchemaFieldValue, optional, nullable) — Values for schema-defined fields on this protein.
- `aliases` (list of string, optional, nullable) — Array of aliases
- `archiveReason` (string, optional, nullable)
- `archived` (boolean, optional)
- `chains` (list of ProteinChain, optional) — The chains and associated amino acid sequences on the protein.
- `createdAt` (string, optional) — DateTime the protein was created.
- `customFields` (list of CustomField, optional, nullable) — Custom fields set on the protein.
- `domains` (list of ProteinDomain, optional) — The domains and associated amino acid sequences on the protein.
- `entityRegistryId` (string, optional, nullable) — The registry-assigned identifier for this item (e.g. its registry ID shown in the UI), present only once the item has been registered. Null if the item is not registered.
- `folder` (FolderRef, optional, nullable)
- `format` (ProteinFormatRef, optional) — The protein format that defines the structure (domains, chains, interactions) for the protein.
- `fullHistory` (string, optional) — `fullHistory` is a superset of `history` that also returns inactive versions that are not part of the current version history. Versions are returned in chronological order (oldest first).
- `history` (string, optional) — Only the currently active version lineage, in chronological order (oldest first). If a change was made and then undone by resetting to an earlier version, the version recording that change is not relevant to the current state of the entity, so it is not included in this listing.
- `id` (string, optional) — ID of the protein.
- `modifiedAt` (string, optional) — DateTime the protein was last modified.
- `name` (string, optional) — Name of the item.
- `outOfSync` (boolean, optional) — Indicates if constituent domain or chain entities have changed since the protein was last updated.
- `outOfSyncReason` (string, optional, nullable) — Any additional information about why the protein is out of sync.
- `project` (ProjectRef, optional, nullable)
- `registrationOrigin` (RegistrationOrigin, optional, nullable) — Provenance of this item's registration — where and when it was registered. Null if unregistered.
- `registry` (RegistryRef, optional, nullable) — The Registry this item belongs to, if registered. Null if unregistered.
- `schema` (EntitySchemaRef, optional) — Use typedSchema instead, which returns the per-type schema.
- `typedSchema` (ProteinSchemaRef, optional) — Schema reference for this protein. Callers can retrieve the schema separately when they need its field definitions.

### UnresolvableEmbeddedItem

Represents an embedded Benchling item that cannot be fetched via the API. The identifier is retained so references persist when document content is copied between documents.

- `__typename` (string, optional)
- `id` (string, optional) — Identifies the embedded item. The identifier is retained for reference only; the item cannot be retrieved.

### CustomColumnDefinition

Specifies a user-defined table column with no additional type-specific fields.

- `__typename` (string, optional)
- `allowsArrayValues` (boolean, optional) — Specifies whether cells in this column may hold multiple values.
- `cellValueType` (string, optional) — Specifies the cell value type for this column.
- `columnId` (string, optional) — Specifies the column identifier within the table.
- `isArchived` (boolean, optional) — Always false. Custom columns are not schema-backed.
- `isLocked` (boolean, optional) — Specifies whether the column width is locked against resizing.
- `isReadonly` (boolean, optional) — Specifies whether cells in this column are read-only.
- `isRequired` (boolean, optional) — Specifies whether a value is required in cells for this column.
- `name` (string, optional) — Specifies the column display name.
- `width` (double, optional, nullable) — Specifies the column width in pixels. Defaults to 100 when unset.

### LookupColumnDefinition

Specifies a table column whose value is derived from a lookup configuration.

- `__typename` (string, optional)
- `allowsArrayValues` (boolean, optional) — Specifies whether cells in this column may hold multiple values.
- `cellValueType` (string, optional) — Specifies the cell value type for this column.
- `columnId` (string, optional) — Specifies the column identifier within the table.
- `isArchived` (boolean, optional) — Always false. Lookup columns are not backed by a schema field.
- `isLocked` (boolean, optional) — Specifies whether the column width is locked against resizing.
- `isReadonly` (boolean, optional) — Specifies whether cells in this column are read-only.
- `isRequired` (boolean, optional) — Specifies whether a value is required in cells for this column.
- `lookupConfigId` (string, optional) — Specifies the API identifier of the lookup configuration.
- `name` (string, optional) — Specifies the column display name.
- `parentColumnId` (string, optional) — Specifies the column identifier of the source column whose values feed this lookup.
- `width` (double, optional, nullable) — Specifies the column width in pixels. Defaults to 100 when unset.

### SchemaFieldColumnDefinition

Specifies a table column backed by a schema field definition.

- `__typename` (string, optional)
- `allowsArrayValues` (boolean, optional) — Specifies whether cells in this column may hold multiple values.
- `cellValueType` (string, optional) — Specifies the cell value type for this column.
- `columnId` (string, optional) — Specifies the column identifier within the table.
- `fieldDefinitionApiId` (string, optional) — Specifies the API identifier of the schema field definition for this column.
- `isArchived` (boolean, optional) — Specifies whether the schema field backing this column has been archived.
- `isLocked` (boolean, optional) — Specifies whether the column width is locked against resizing.
- `isReadonly` (boolean, optional) — Specifies whether cells in this column are read-only.
- `isRequired` (boolean, optional) — Specifies whether a value is required in cells for this column.
- `name` (string, optional) — Specifies the column display name.
- `width` (double, optional, nullable) — Specifies the column width in pixels. Defaults to 100 when unset.

### SystemColumnDefinition

Specifies a system-managed table column with a predefined purpose.

- `__typename` (string, optional)
- `allowsArrayValues` (boolean, optional) — Specifies whether cells in this column may hold multiple values.
- `cellValueType` (string, optional) — Specifies the cell value type for this column.
- `columnGroup` (string, optional, nullable) — Specifies the logical grouping identifier for this column in certain table types, such as source or target in transfer tables or quantity or concentration in inventory tables. Null when the column has no group.
- `columnId` (string, optional) — Specifies the column identifier within the table.
- `isArchived` (boolean, optional) — Always false. System columns are not backed by a schema field.
- `isLocked` (boolean, optional) — Specifies whether the column width is locked against resizing.
- `isReadonly` (boolean, optional) — Specifies whether cells in this column are read-only.
- `isRequired` (boolean, optional) — Specifies whether a value is required in cells for this column.
- `name` (string, optional) — Specifies the column display name.
- `systemPurpose` (string, optional) — Specifies the system-defined purpose of this column.
- `width` (double, optional, nullable) — Specifies the column width in pixels. Defaults to 100 when unset.

### TableCell

Specifies a cell within an unstructured table row. Cells may be standalone or participate in a merged region. The anchor cell holds the merged region span; other cells in the region reference the anchor cell coordinates.

- `__typename` (string, optional)
- `errors` (list of CellError, optional) — Lists evaluation and validation errors present on the cell. Inspect the error type on each error to distinguish evaluation failures from validation failures.
- `evaluationValue` (TableCellEvaluationValue, optional, nullable) — Specifies the evaluated value computed by formula evaluation, when present. Read-only.
- `format` (TableCellFormat, optional, nullable) — Specifies formatting properties applied to the cell. Null when the cell has no formatting.
- `inputValue` (TableCellInputValue, optional) — Specifies the cell input value. For unstructured tables this is always a text value.
- `mergeRange` (TableMergeRange, optional, nullable) — Specifies the merged region span on the anchor cell. Present only on anchor cells.
- `mergeRangeParent` (MergedCellAnchor, optional, nullable) — Specifies coordinates of the anchor cell. Present on cells within a merged region that are not the anchor.
- `selectorId` (string, optional, nullable) — Specifies the dropdown selector identifier for this cell, when present. Match this value to selectorId on dropdown selectors defined on the document.

### SchemaFieldValue

Represents a field value on a schematized object, pairing a `fieldDefinition` (describing the field's type and constraints) with its actual `value` (a `BenchlingValue` such as text, number, date, or link to another object). The value may be null if no value has been set. Used within the `schemaFields` collection on objects that implement `HasSchema` to provide access to all custom field values defined by the object's schema.

- `__typename` (string, optional)
- `fieldDefinition` (SchemaFieldDefinitionRef, optional)
- `id` (string, optional)
- `linkedEntityId` (string, optional, nullable)
- `value` (SchemaFieldValueValue, optional, nullable) — Union of BooleanValue, DateTimeValue, DateValue, DecimalValue, IntegerValue, JsonValue, ObjectLinkValue, ObjectLinkListValue, TextAndUrlValue, TextValue, ArrayValue

### CustomField

A name-value pair for storing additional metadata on objects that support custom fields. CustomFields provide a flexible way to attach arbitrary string data to entities, containers, datasets, and other Benchling objects without modifying their schemas. Objects that can have custom fields implement the HasCustomFields interface. Unlike schema-defined fields, custom fields are not validated against a schema and can be freely added or modified.

- `__typename` (string, optional)
- `name` (string, optional, nullable)
- `value` (string, optional, nullable)

### FolderRef

- `__typename` (string, optional)
- `id` (string, optional)

### ProjectRef

- `__typename` (string, optional)
- `id` (string, optional)

### RegistrationOrigin

Captures the provenance of an entity's registration into the registry. The `originEntry` links to the `DocumentLike` (typically an entry or notebook) from which the entity was registered, providing traceability back to the original experimental context. The `registeredAt` timestamp records when the registration occurred. This information helps scientists understand where registered entities came from and when they were added to the registry.

- `__typename` (string, optional)
- `originEntry` (DocumentLikeRef, optional, nullable)
- `registeredAt` (string, optional, nullable)

### RegistryRef

- `__typename` (string, optional)
- `id` (string, optional)

### EntitySchemaRef

- `__typename` (string, optional)
- `id` (string, optional)

### AaSequenceSchemaRef

- `__typename` (string, optional)
- `id` (string, optional)

### CustomEntitySchemaRef

- `__typename` (string, optional)
- `id` (string, optional)

### DnaSequenceSchemaRef

- `__typename` (string, optional)
- `id` (string, optional)

### ReviewRef

- `__typename` (string, optional)
- `id` (string, optional)

### EntrySchemaRef

- `__typename` (string, optional)
- `id` (string, optional)

### EntrySection

Represents a logical section within an Entry used to organize content into collapsible groups. While sections include a date field and were historically known as "Entry Days," they are flexible groupings that users can organize however they want—chronologically, thematically, or by any other criteria. Each section may have a title, date, and contains a list of content items (see `EntryContent`) such as text blocks, tables, and attachments. Sections are collapsible in the UI, which helps when rendering large notebook entries.

- `__typename` (string, optional)
- `contents` (list of EntryContent, optional, nullable)
- `date` (string, optional, nullable)
- `provenanceUuid` (string, optional)
- `title` (string, optional, nullable)

### TableCellSelector

Specifies a predefined dropdown selector that can be assigned to table cells.

- `__typename` (string, optional)
- `name` (string, optional) — Specifies the display name of the selector.
- `options` (list of string, optional) — Lists the allowed dropdown option values.
- `selectorId` (string, optional) — Specifies the selector identifier within the document. Matches the selectorId field on table cells.

### NucleotideSimplePolymer

Represents a nucleic acid strand (DNA or RNA) within a complex polymer structure. Contains the sequence residues and connections to other polymers. The entity field links to a corresponding DnaSequence, RnaSequence, DnaOligo, or RnaOligo. Used as the backbone component in OligoConjugate and as forward/reverse strands in OligoDuplex.

- `__typename` (string, optional)
- `connections` (list of MolecularConnection, optional) — This polymer's connections to other polymers in the complex polymer.
- `entity` (NucleotideSequenceRef, optional) — The Benchling entity information for this simple polymer.
- `helmReference` (string, optional) — The HELM reference of this polymer (e.g. RNA1). Uniquely identifies this simple polymer in the context of a single complex polymer.
- `nucleotideType` (enum, optional) — Whether this strand is DNA or RNA.
  - Allowed values: `DNA`, `RNA`
- `polymerType` (string, optional) — The HELM polymer type for this strand. This is always `RNA` for nucleotide simple polymers, including DNA sequences. Use `nucleotideType` to distinguish DNA from RNA.
- `residues` (string, optional) — The nucleotide base sequence of this strand.

### IOligoConjugateConjugatesItem

Union of NucleotideSimplePolymer, ChemSimplePolymer

### OligoConjugateStructure

Contains the complete structural definition of an oligo conjugate, including its oligonucleotide backbone, conjugated molecules and peptides, and the connections between them. For each simple polymer, restricted read access on the linked entity affects `entity` only; structural fields on that polymer are still populated for the containing conjugate.

- `__typename` (string, optional)
- `connections` (list of MolecularConnection, optional) — A list of all the connections between simple polymers in this oligo conjugate.
- `resolvedAttachments` (list of MolecularConjugate, optional) — A list of attachment information, providing a more detailed chemical structure for a set of connections.
- `simplePolymers` (list of OligoConjugateStructureSimplePolymersItem, optional) — A list of all the simple polymers in this oligo conjugate.

### OligoConjugateSchemaRef

- `__typename` (string, optional)
- `id` (string, optional)

### IOligoDuplexConjugatesItem

Union of NucleotideSimplePolymer, ChemSimplePolymer

### OligoDuplexStructure

Contains the complete structural definition of an oligo duplex, including its forward and reverse strands, any conjugated molecules and peptides, and the connections between them. For each simple polymer, restricted read access on the linked entity affects `entity` only; structural fields on that polymer are still populated for the containing duplex.

- `__typename` (string, optional)
- `connections` (list of MolecularConnection, optional) — A list of all the connections between simple polymers in this oligo duplex.
- `resolvedAttachments` (list of MolecularConjugate, optional) — A list of attachment information, providing a more detailed chemical structure for a set of connections.
- `simplePolymers` (list of OligoDuplexStructureSimplePolymersItem, optional) — A list of all the simple polymers in this oligo duplex.

### OligoDuplexSchemaRef

- `__typename` (string, optional)
- `id` (string, optional)

### ProteinChain

Represents a polypeptide chain within an `Protein`, containing the domain composition. Each chain has a computed label derived from the format.

- `__typename` (string, optional)
- `chainPositions` (list of ProteinFormatChainPosition, optional) — Each chain position of this chain in the protein. If a chain has multiplicity > 1, each chain position will be listed here.
- `domains` (list of ProteinDomain, optional) — Each domain on the chain, ordered according to the format.
- `entity` (AaSequenceRef, optional) — The amino acid sequence entity associated with the chain.
- `label` (string, optional) — Unique label for the chain, computed from the format.
- `type` (enum, optional) — The type of the chain.
  - Allowed values: `HEAVY`, `LIGHT`, `NONE`, `ALPHA`, `BETA`, `JOINING`

### ProteinDomain

Represents a domain within an `Protein`, containing the actual amino acid sequence for a specific label. Unlike `ProteinFormatDomain` which is a template, `ProteinDomain` is a concrete instance of the domain and links to the underlying amino acid sequence entity.

- `__typename` (string, optional)
- `domainPositions` (list of ProteinFormatDomainPosition, optional) — Each domain position of this domain in the protein. If this domain appears multiple times in the physical structure of the protein, each domain position will be listed here.
- `entity` (AaSequenceRef, optional) — The amino acid sequence entity associated with the domain.
- `label` (string, optional) — A human-readable label for the domain.
- `type` (enum, optional) — The type of the domain.
  - Allowed values: `VL`, `CL`, `VH`, `VHH`, `CH1`, `CH2`, `CH3`, `CH4`, `J`, `H`, `L`, `VA`, `CA`, `VB`, `CB`, `VG`, `CG`, `VD`, `CD`, `F`, `ELEMENT`

### ProteinFormatRef

- `__typename` (string, optional)
- `id` (string, optional)

### ProteinSchemaRef

- `__typename` (string, optional)
- `id` (string, optional)

### CellError

Specifies a single error present on a table cell. The error type field distinguishes evaluation failures from validation failures; message is the error description.

- `__typename` (string, optional)
- `errorType` (enum, optional) — Specifies whether the error is an evaluation failure or a validation failure.
  - Allowed values: `EVALUATION`, `VALIDATION`
- `message` (string, optional) — Specifies the error message.
- `type` (string, optional, nullable) — Specifies the display name for the specific error, such as reference error or value error. Populated for evaluation errors; null for validation errors.

### TableCellEvaluationValue

### TableCellFormat

Specifies formatting properties applied to an entire table cell.

- `__typename` (string, optional)
- `alignment` (enum, optional, nullable) — Specifies horizontal text alignment for the cell, when set.
  - Allowed values: `LEFT`, `CENTER`, `RIGHT`
- `backgroundColor` (string, optional, nullable) — Specifies the background color applied to the cell, when set.
- `foregroundColor` (string, optional, nullable) — Specifies the text color applied to the cell, when set.
- `link` (string, optional, nullable) — Specifies a hyperlink URL applied to the cell, when set.
- `precision` (integer, optional, nullable) — Specifies the decimal precision used to display a numeric cell.
- `properties` (list of enum, optional) — Lists character style properties applied to the cell.
  - Allowed values: `BOLD`, `ITALIC`, `UNDERLINE`, `STRIKETHROUGH`, `IMPORTANT`
- `scientificNotation` (boolean, optional, nullable) — Specifies whether a numeric cell is displayed in scientific notation.

### TableCellInputValue

Specifies the cell input value. For unstructured tables this is always a text value.

### TableMergeRange

Specifies the extent of a merged cell region, set on the anchor cell.

- `__typename` (string, optional)
- `mergeColSpan` (integer, optional) — Specifies the number of columns in the merged region, including the anchor cell.
- `mergeRowSpan` (integer, optional) — Specifies the number of rows in the merged region, including the anchor cell.

### MergedCellAnchor

Specifies coordinates of the anchor cell for a cell within a merged region.

- `__typename` (string, optional)
- `col` (integer, optional) — Specifies the zero-based column index of the anchor cell.
- `row` (integer, optional) — Specifies the zero-based row index of the anchor cell.

### SchemaFieldDefinitionRef

- `__typename` (string, optional)
- `id` (string, optional)

### SchemaFieldValueValue

### DocumentLikeRef

- `__typename` (string, optional)
- `id` (string, optional)

### EntryContent

Represents a single content item within an EntrySection. The `type` field indicates what kind of content this is (see `ContentType`). This provides a simplified view of entry content categorization.

- `__typename` (string, optional)
- `type` (enum, optional, nullable)
  - Allowed values: `TEXT`, `LIST_ITEM`, `HEADER`, `CODE_BLOCK`, `UNSTRUCTURED_TABLE`, `PLACEHOLDER`, `EXTERNAL_FILE`, `ASSAY_RUN`, `STRUCTURED_TABLE`, `OTHER`

### MolecularConnection

Represents a chemical bond between two polymers within a complex polymer structure. Connections can be covalent bonds (including disulfide bonds) or hydrogen bonds (for base pairing in duplexes). Each connection has source and target ConnectionSide endpoints defining which polymers and residues are bonded. The attachmentStyle indicates whether the connection was drawn graphically or specified via leaving groups.

- `__typename` (string, optional)
- `attachmentStyle` (enum, optional, nullable) — The format in which the user has defined the connection (i.e. drawn vs leaving group style). Only applicable to covalent bond type connections.
  - Allowed values: `LEAVING_GROUP`, `DRAWN`
- `connectionType` (enum, optional) — The kind of chemical bond this connection represents.
  - Allowed values: `COVALENT_BOND`, `HYDROGEN_BOND`
- `covalentBondType` (enum, optional, nullable) — The type of covalent bond represented by the connection (i.e. disulfide bond or not). Only applicable to covalent bond type connections.
  - Allowed values: `DISULFIDE_BOND`
- `source` (ConnectionSide, optional) — 'source' and 'target' are interchangeable - connections are bidirectional.
- `target` (ConnectionSide, optional) — Represents one endpoint of a connection between polymers in a complex polymer structure. Identifies the specific attachment point including the polymer reference, residue position (for sequences), modification type (for nucleotides), and R-group number (for specific attachment sites on monomers). Each MolecularConnection has a source and target ConnectionSide defining the two endpoints of the bond.

### NucleotideSequenceRef

- `__typename` (string, optional)
- `id` (string, optional)

### ChemSimplePolymer

Represents a small molecule within a complex polymer structure. Contains SMILES and molfile representations of the chemical structure, along with connections to other polymers. The entity field links to a corresponding `Molecule`. Commonly used as conjugate payloads attached to oligonucleotide backbones, such as lipid nanoparticles, fluorescent labels, or therapeutic molecules.

- `__typename` (string, optional)
- `connections` (list of MolecularConnection, optional) — This polymer's connections to other polymers in the complex polymer.
- `entity` (MoleculeRef, optional) — The Benchling entity information for this simple polymer.
- `helmReference` (string, optional) — The HELM reference of this polymer (e.g. CHEM1). Uniquely identifies this simple polymer in the context of a single complex polymer.
- `molfile` (string, optional) — The molfile representation of this small molecule's chemical structure.
- `polymerType` (string, optional) — The HELM polymer type for this small molecule. This is always `CHEM` for chem simple polymers.
- `smiles` (string, optional) — The chemical structure of this small molecule in SMILES format.

### MolecularConjugate

Detailed information about a molecular conjugate formed by a group of contiguous connections in a complex polymer. The entire chemical structure of the molecular conjugate, and any components inside it, is represented by a molfile. This allows for the representation of any bond chemistry, beyond the simple leaving group style supported by HELM. For example, suppose we have two involved connections, one between a backbone oligo and a linker molecule, and another between the linker molecule and a payload molecule. Then the molfile would represent the entire complex of: - the monomer on the backbone where the linker attaches - the connection between monomer and linker - the linker molecule - the connection between linker and payload - the payload molecule Currently, this structure will only represent user-drawn attachments. However, in the future, this object may also contain leaving group style connections as well.

- `__typename` (string, optional)
- `connectionsInvolved` (list of MolecularConnection, optional) — The molecular connections that comprise this conjugate. Together these connections define the bonded region represented by the molfile.
- `molfile` (string, optional) — The molfile representation of the molecular conjugate's chemical structure, including all bonded components represented by this conjugate.

### OligoConjugateStructureSimplePolymersItem

Union of NucleotideSimplePolymer, ChemSimplePolymer, PeptideSimplePolymer, ProteinSimplePolymer

### OligoDuplexStructureSimplePolymersItem

Union of NucleotideSimplePolymer, ChemSimplePolymer, PeptideSimplePolymer, ProteinSimplePolymer

### ProteinFormatChainPosition

Defines each instance of a polypeptide chain within a `ProteinFormat`, specifying the chain type and its constituent domains. Each chain position has a unique ref identifier and lists the domain positions (see `ProteinFormatDomainPosition`) that compose it in order from N-terminus to C-terminus. For example, a heavy chain position might reference domain positions [VH, CH1, Hinge, CH2, CH3].

- `__typename` (string, optional)
- `domainPositions` (list of ProteinFormatDomainPosition, optional) — A list of all the domain positions that make up the chain position, in order
- `ref` (integer, optional) — A unique identifier for a physical component (chain or domain) in a protein format. This is used to form a HELM reference that is used in the protein's complex polymer structure.
- `type` (enum, optional) — Type of the chain.
  - Allowed values: `HEAVY`, `LIGHT`, `NONE`, `ALPHA`, `BETA`, `JOINING`

### AaSequenceRef

- `__typename` (string, optional)
- `id` (string, optional)

### ProteinFormatDomainPosition

Defines a domain position within a `ProteinFormat`, specifying the domain type and identity of each physical domain in the protein format. Each domain position has a unique ref identifier used to construct HELM notation for complex polymer structures. Domain positions are grouped into ProteinFormatDomains, and each group can be uniquely identified by its label, and will be a single amino acid sequence entity in proteins of this format.

- `__typename` (string, optional)
- `optional` (boolean, optional) — Whether this domain is optional in the format. If true, entities of this format may not have this domain.
- `ref` (integer, optional) — A unique identifier for a physical component (chain or domain) in a protein format. This is used to form a HELM reference that is used in the protein's complex polymer structure.
- `type` (enum, optional) — Type of the domain
  - Allowed values: `VL`, `CL`, `VH`, `VHH`, `CH1`, `CH2`, `CH3`, `CH4`, `J`, `H`, `L`, `VA`, `CA`, `VB`, `CB`, `VG`, `CG`, `VD`, `CD`, `F`, `ELEMENT`

### StringCellEvaluationValue

Specifies a string evaluation value.

- `__typename` (string, optional)
- `value` (string, optional) — Specifies the evaluated string value.

### NumberCellEvaluationValue

Specifies a numeric evaluation value. Display formatting lives on TableCell.format.

- `__typename` (string, optional)
- `value` (string, optional) — Specifies the evaluated numeric value, carrying the most precise representation available for the cell's typed value. Serialized as a string and never pre-formatted; use TableCell.format for display formatting.

### BooleanCellEvaluationValue

Specifies a boolean evaluation value.

- `__typename` (string, optional)
- `value` (boolean, optional) — Specifies the evaluated boolean value.

### DateCellEvaluationValue

Specifies a date evaluation value.

- `__typename` (string, optional)
- `value` (date, optional) — Specifies the evaluated date value.

### DateTimeCellEvaluationValue

Specifies a datetime evaluation value.

- `__typename` (string, optional)
- `value` (string, optional) — Specifies the evaluated datetime value.

### ObjectLinkCellEvaluationValue

The evaluation-value counterpart of ObjectLinkValue: a flat id/name pair for any LinkableDomainObject a cell links to, which includes non-entity targets such as users, teams, studies, inventory items, attachments, and dropdown options. Resolve inputValue to get the concrete type.

- `__typename` (string, optional)
- `id` (string, optional) — Identifies the linked object.
- `name` (string, optional) — Specifies the display name of the linked entity.

### ArrayCellEvaluationValue

Specifies an array evaluation value containing multiple cell evaluation values.

- `__typename` (string, optional)
- `value` (list of ArrayCellEvaluationValueValueItem, optional) — Lists the evaluated values in the array.

### UnsupportedCellEvaluationValue

Specifies an evaluation value for types that cannot be represented in the current API. Use the cell input value as a fallback.

- `__typename` (string, optional)
- `errorReason` (string, optional) — Specifies the reason the evaluation value could not be represented.

### BooleanValue

A type that represents boolean values.

- `__typename` (string, optional)
- `value` (boolean, optional) — The boolean value.

### DateTimeValue

A type that represents datetime values.

- `__typename` (string, optional)
- `value` (string, optional) — The datetime value with UTC as the timezone.

### DateValue

A type that represents date values.

- `__typename` (string, optional)
- `value` (date, optional) — The date value.

### DecimalValue

A type that represents decimal value as strings.

- `__typename` (string, optional)
- `value` (string, optional, nullable) — The decimal value in a string representation
- `numericValue` (double, optional, nullable, deprecated) — Deprecated. The float representation of the decimal value.

### IntegerValue

A type that represents integer values.

- `__typename` (string, optional)
- `value` (integer, optional) — The integer value.

### JsonValue

A type that represents JSON values.

- `__typename` (string, optional)
- `value` (map from string to any, optional) — The JSON value.

### ObjectLinkValue

A type that represents links to other objects.

- `__typename` (string, optional)
- `value` (ObjectRef, optional) — The object that this value links to, or an Inaccessible object if not found with the current permission set.

### ObjectLinkListValue

A type that represents a list of links to other objects.

- `__typename` (string, optional)
- `value` (list of ObjectRef, optional) — The list of objects that this value links to. Inaccessible objects may be returned instead if the object is not found with the current permission set.

### TextAndUrlValue

A type that represents text (string) values with an associated URL.

- `__typename` (string, optional)
- `url` (string, optional) — The URL associated with the value. Please use `TextValue` if you don't want a URL.
- `value` (string, optional) — The text value. It may or may not be an empty string.

### TextValue

A type that represents text (string) values.

- `__typename` (string, optional)
- `value` (string, optional) — The text value. It may or may not be an empty string.

### ArrayValue

A type that represents a list of BenchlingValues, used for multi-value cells (e.g. alias columns).

- `__typename` (string, optional)
- `value` (list of ArrayValueValueItem, optional)

### ConnectionSide

Represents one endpoint of a connection between polymers in a complex polymer structure. Identifies the specific attachment point including the polymer reference, residue position (for sequences), modification type (for nucleotides), and R-group number (for specific attachment sites on monomers). Each MolecularConnection has a source and target ConnectionSide defining the two endpoints of the bond.

- `__typename` (string, optional)
- `modificationType` (enum, optional, nullable) — Benchling has no concept of monomer index like HELM does, so specifying the modification type is our way of telling the particular monomer for an attachment on a nucleotide polymer. For non-nucleotide polymers, this is always null since we would only have one monomer at a particular index.
  - Allowed values: `SUGAR`, `BASE`, `PHOSPHATE`
- `polymerRef` (string, optional) — The ref of the simple polymer connected at this attachment point.
- `rGroup` (integer, optional, nullable) — The r-group number designates the specific attachment site on the monomer used by this connection. If not null, always >= 1.
- `residueIndex` (integer, optional, nullable) — For sequence types, the index of the residue at this attachment point. residueIndex is always 0 or null for CHEM polymers since we never have more than one "residue".

### MoleculeRef

- `__typename` (string, optional)
- `id` (string, optional)

### PeptideSimplePolymer

Represents a peptide or protein chain within a complex polymer structure. Contains the amino acid residue sequence and connections to other polymers. The entity field links to a corresponding `AaSequence`. Used when protein/aa-sequence components are part of larger bioconjugate structures.

- `__typename` (string, optional)
- `connections` (list of MolecularConnection, optional) — This polymer's connections to other polymers in the complex polymer.
- `entity` (AaSequenceRef, optional) — The Benchling entity information for this simple polymer.
- `helmReference` (string, optional) — The HELM reference of this polymer (e.g. PEPTIDE1). Uniquely identifies this simple polymer in the context of a single complex polymer.
- `polymerType` (string, optional) — The HELM polymer type for this peptide or protein chain. This is always `PEPTIDE` for peptide simple polymers.
- `residues` (string, optional) — The amino acid residue sequence of this peptide or protein chain.

### ProteinSimplePolymer

Represents a protein nested by reference within a complex polymer structure, along with connections to other polymers. The entity field links to the corresponding `Protein`, and the nested protein's own structure stays on that protein rather than being copied into the containing structure.

- `__typename` (string, optional)
- `connections` (list of MolecularConnection, optional) — This polymer's connections to other polymers in the complex polymer.
- `entity` (ProteinRef, optional) — The nested protein. This always reflects the protein's current state, which can differ from `nestedComplexPolymerVersion` if the protein has changed since the containing structure was written.
- `helmReference` (string, optional) — The HELM reference of this polymer (e.g. PROTEIN1). Uniquely identifies this simple polymer in the context of a single complex polymer.
- `nestedComplexPolymerVersion` (ProteinVersionRef, optional, nullable) — The version of the nested protein that the containing structure was written against. Null when the viewer cannot read the nested protein.
- `polymerType` (string, optional) — The HELM polymer type for this nested protein. This is always `PROTEIN` for protein simple polymers.

### ArrayCellEvaluationValueValueItem

Union of StringCellEvaluationValue, NumberCellEvaluationValue, BooleanCellEvaluationValue, DateCellEvaluationValue, DateTimeCellEvaluationValue, ObjectLinkCellEvaluationValue, ArrayCellEvaluationValue, UnsupportedCellEvaluationValue

### ObjectRef

- `__typename` (string, optional)
- `id` (string, optional)

### ArrayValueValueItem

Union of BooleanValue, DateTimeValue, DateValue, DecimalValue, IntegerValue, JsonValue, ObjectLinkValue, ObjectLinkListValue, TextAndUrlValue, TextValue

### ProteinRef

- `__typename` (string, optional)
- `id` (string, optional)

### ProteinVersionRef

- `__typename` (string, optional)
- `id` (string, optional)

## Examples

**Response**

```json
{
  "items": [
    {
      "__typename": "__typename",
      "createdAt": "createdAt",
      "id": "id",
      "indentation": 1,
      "modifiedAt": "modifiedAt"
    }
  ],
  "nextToken": "nextToken"
}
```

**SDK Code**

```python
import requests

url = "https://{tenant_name}.benchling.com/api/v3/entry/entry_id/parts/items"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://{tenant_name}.benchling.com/api/v3/entry/entry_id/parts/items';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```