Skip to navigation
Benchling APIProtein Format

Create ProteinFormat

Create ProteinFormat.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
veritasNamestringRequired

VERITAS name that defines the protein format structure and visualization. Must be a supported VERITAS format name; invalid or unsupported values are rejected. The structure implied by this name cannot be changed after the format is created. Creating a custom protein format requires Biologics create access for the authenticated user or app.

namestringOptional

Display name of the protein format. When omitted, the VERITAS name is used. When provided, the name must be non-empty after stripping whitespace, at most 255 characters, and unique among all protein format names in the organization (including built-in format names).

Response

Created
__typenamestringOptional
archiveReasonstring or nullOptional
archivedbooleanOptional
builtInbooleanOptional

Whether this is an out-of-the-box Benchling-provided format. These formats come pre-loaded and cannot be modified or deleted by users.

chainPositionslist of objectsOptional
Format chain positions include all physical instances of each chain in a protein of this format.
chainslist of objectsOptional
The chains of protein entities of this format. Each chain can have multiple chain sites, representing multiple physical instances of the same chain.
createdAtstringOptional
When the protein format was created.
domainPositionslist of objectsOptional
Format domain positions include all physical instances of each domain in a protein of this format.
domainslist of objectsOptional
The domains of protein entities of this format. Each domain can have multiple domain sites, representing multiple physical instances of the same domain.
idstringOptional

API identifier of the protein format. Custom formats use the abfmt_ prefix; built-in formats use builtinabfmt_.

modifiedAtstringOptional
When the protein format was last modified.
namestringOptional
The display name of the protein format.
originalVeritasstring or nullOptional
The VERITAS string used to create the format.
variablePairslist of objectsOptional

Variable domain pairs defined on this format (e.g., VH/VL for antibodies). Each pair identifies two variable domains that together form an antigen-binding site.

Errors

400
Protein Format Create Request Bad Request Error
403
Protein Format Create Request Forbidden Error
404
Protein Format Create Request Not Found Error
409
Protein Format Create Request Conflict Error
429
Protein Format Create Request Too Many Requests Error
500
Protein Format Create Request Internal Server Error