For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Bearer authentication of the form Bearer <token>, where token is your auth token.
Headers
EARLY-ACCESSstringOptional
Set to true to access beta operations via /api/v3.
Request
This endpoint expects an object.
chainLinkedSchemaslist of objectsRequired
Schema mappings for chain labels in the protein format.
descriptionstringRequired
A human-readable description of the schema. At most 1000 characters.
domainLinkedSchemaslist of objectsRequired
Schema mappings for each domain label in the protein format.
formatIdstringRequired
API ID of the protein format that defines the protein schema structure.
itemIdPrefixstringRequired
organizationIdstringRequired
The API ID of the organization this schema belongs to. The organization must exist and be accessible to the caller.
availableRegistrationNamingOptionslist of enumsOptional
fieldDefinitionslist of objectsOptional
Optional schema field definitions to create on the protein schema.
fieldsetslist of stringsOptional
includeRegistryIdInChipsbooleanOptional
isContainablebooleanOptional
namestringOptional
The user-facing name of the schema. Must be non-empty after stripping whitespace, at most 255 characters, and unique within the organization.
systemCategorieslist of objectsOptional
systemNamestringOptional
The SQL identifier used as the warehouse table name. If not provided, one is auto-generated from the display name. Must match the pattern [a-z_][a-z0-9_$]*, cannot be a reserved table name, cannot start with ‘bnch$’, and must be unique within the organization.
useRegistryIdForItemDisplayLabelbooleanOptional
displayNamestringOptionalDeprecated
Deprecated. Use name instead.
Response
Created
__typenamestringOptional
archiveReasonstring or nullOptional
archivedbooleanOptional
availableRegistrationNamingOptionslist of enumsOptional
chainLinkedSchemaslist of objectsOptional
Schema or interface links for each chain label in the protein format.
constraintobject or nullOptional
Defines uniqueness requirements for entities within a schema. Constraints ensure that
registered entities have unique values across specified fields (see fieldDefinitionNames)
or unique domain-specific properties (see TypeSpecificConstraint). The hasUniqueResidues
field is a legacy indicator for sequence uniqueness.
containableTypeenumOptional
Allowed values:
containerNameTemplateobject or nullOptional
A name template for containers.
createdAtstring or nullOptional
descriptionstringOptional
domainLinkedSchemaslist of objectsOptional
Schema or interface links for each domain type in the protein format.
fieldDefinitionsstringOptionalformat: "uri"
fieldsetsstringOptionalformat: "uri"
formatobjectOptional
The protein format that defines the structure (domains, chains, interactions) for entities of this schema.
iconIdenumOptional
Allowed values:
idstringOptional
includeRegistryIdInChipsbooleanOptional
itemIdPrefixstringOptional
modifiedAtstringOptional
namestringOptional
nameTemplateobject or nullOptional
A name template for entities.
organizationobjectOptional
systemCategorieslist of objectsOptional
systemNamestringOptional
useRegistryIdForItemDisplayLabelbooleanOptional
validationRulesstringOptionalformat: "uri"
Errors
400
Protein Schema Create Request Bad Request Error
403
Protein Schema Create Request Forbidden Error
404
Protein Schema Create Request Not Found Error
409
Protein Schema Create Request Conflict Error
429
Protein Schema Create Request Too Many Requests Error
500
Protein Schema Create Request Internal Server Error
