Sequence Redesign

Redesign selected protein residues in one fixed CIF structure. Use the top-level type discriminator to choose binder redesign, with target and binder chain roles, or generic redesign. Every chain in the input structure must be assigned exactly once. Binder results include binding and structure metrics; generic results include structure and secondary-structure metrics.

Start a protein sequence redesign run

POST/compute/v1/protein/sequence-redesign

List protein sequence redesign runs

GET/compute/v1/protein/sequence-redesign

Get protein sequence redesign run status

GET/compute/v1/protein/sequence-redesign/{id}

Get redesigned protein sequences

GET/compute/v1/protein/sequence-redesign/{id}/results

Stop a running protein sequence redesign run

POST/compute/v1/protein/sequence-redesign/{id}/stop

Resume a stopped protein sequence redesign run

POST/compute/v1/protein/sequence-redesign/{id}/resume

Delete protein sequence redesign run data

POST/compute/v1/protein/sequence-redesign/{id}/delete-data

Estimate cost for a protein sequence redesign run

POST/compute/v1/protein/sequence-redesign/estimate-cost

ModelsExpand Collapse

SequenceRedesignStartResponse object { id, completed_at, created_at, 14 more }

A fixed-structure protein sequence redesign run.

id: string

Unique ProteinSequenceRedesignRun identifier

completed_at: string

formatdate-time

created_at: string

formatdate-time

data_deleted_at: string

When the input, output, and result data was permanently deleted. Null if data has not been deleted.

formatdate-time

Deprecatedengine: "boltz-protein-redesign"

Use pipeline instead.

Deprecated. Use pipeline instead.

Deprecatedengine_version: "v2026-07-14"

Use pipeline_version instead.

Deprecated. Use pipeline_version instead.

error: object { code, message, details }

code: string

Machine-readable error code

message: string

Human-readable error message

details: optional unknown

Additional field-level error details keyed by input path, when available.

input: object { entities, num_proteins, structure, 4 more } or object { entities, num_proteins, structure, 4 more }

Pipeline input (null if data deleted)

One of the following:

BinderProteinSequenceRedesignRunInputResponse object { entities, num_proteins, structure, 4 more }

entities: array of object { chain_id, role, type } or object { chain_id, role, type, design_motifs }

Every chain in the input CIF, assigned exactly once as target or binder.

One of the following:

BinderSequenceRedesignTargetEntityResponse object { chain_id, role, type }

A fixed target chain from the input CIF.

chain_id: string

minLength1

role: "target"

type: "from_template"

BinderSequenceRedesignBinderEntityResponse object { chain_id, role, type, design_motifs }

chain_id: string

minLength1

role: "binder"

type: "from_template"

design_motifs: optional array of object { filters, residues, type }

Residues to redesign. Omit this field to keep the binder chain fixed.

filters: array of object { amino_acids, type } or object { max_fraction, type } or object { motifs, type }

Filters applied to this motif in addition to global_design_filters.

One of the following:

ExcludedAminoAcidsDesignFilterResponse object { amino_acids, type }

amino_acids: array of string

Single-letter amino-acid codes that must not occur in the filtered designed region.

type: "excluded_amino_acids"

MaxHydrophobicFractionDesignFilterResponse object { max_fraction, type }

max_fraction: number

minimum0

maximum1

type: "max_hydrophobic_fraction"

ExcludedSequenceMotifsDesignFilterResponse object { motifs, type }

motifs: array of string

Sequence motifs that must not occur. X matches any single residue.

type: "excluded_sequence_motifs"

residues: array of number

0-indexed residues to redesign on this chain.

type: "residues"

num_proteins: number

Number of unique filter-passing redesigned proteins to generate.

minimum1

maximum1000

structure: object { url, url_expires_at }

url: string

URL to download the file

formaturi

url_expires_at: string

When the presigned URL expires

formatdate-time

type: "binder"

global_design_filters: optional array of object { amino_acids, type } or object { max_fraction, type } or object { motifs, type }

Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters.

One of the following:

ExcludedAminoAcidsDesignFilterResponse object { amino_acids, type }

amino_acids: array of string

Single-letter amino-acid codes that must not occur in the filtered designed region.

type: "excluded_amino_acids"

MaxHydrophobicFractionDesignFilterResponse object { max_fraction, type }

max_fraction: number

minimum0

maximum1

type: "max_hydrophobic_fraction"

ExcludedSequenceMotifsDesignFilterResponse object { motifs, type }

motifs: array of string

Sequence motifs that must not occur. X matches any single residue.

type: "excluded_sequence_motifs"

idempotency_key: optional string

maxLength255

workspace_id: optional string

Workspace to run this redesign in.

GenericProteinSequenceRedesignRunInputResponse object { entities, num_proteins, structure, 4 more }

entities: array of object { chain_id, type, design_motifs }

Every chain in the input CIF, assigned exactly once.

chain_id: string

minLength1

type: "from_template"

design_motifs: optional array of object { filters, residues, type }

Residues to redesign. Omit this field to keep the chain fixed.

filters: array of object { amino_acids, type } or object { max_fraction, type } or object { motifs, type }

Filters applied to this motif in addition to global_design_filters.

One of the following:

ExcludedAminoAcidsDesignFilterResponse object { amino_acids, type }

amino_acids: array of string

Single-letter amino-acid codes that must not occur in the filtered designed region.

type: "excluded_amino_acids"

MaxHydrophobicFractionDesignFilterResponse object { max_fraction, type }

max_fraction: number

minimum0

maximum1

type: "max_hydrophobic_fraction"

ExcludedSequenceMotifsDesignFilterResponse object { motifs, type }

motifs: array of string

Sequence motifs that must not occur. X matches any single residue.

type: "excluded_sequence_motifs"

residues: array of number

0-indexed residues to redesign on this chain.

type: "residues"

num_proteins: number

Number of unique filter-passing redesigned proteins to generate.

minimum1

maximum1000

structure: object { url, url_expires_at }

url: string

URL to download the file

formaturi

url_expires_at: string

When the presigned URL expires

formatdate-time

type: "generic"

global_design_filters: optional array of object { amino_acids, type } or object { max_fraction, type } or object { motifs, type }

Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters.

One of the following:

ExcludedAminoAcidsDesignFilterResponse object { amino_acids, type }

amino_acids: array of string

Single-letter amino-acid codes that must not occur in the filtered designed region.

type: "excluded_amino_acids"

MaxHydrophobicFractionDesignFilterResponse object { max_fraction, type }

max_fraction: number

minimum0

maximum1

type: "max_hydrophobic_fraction"

ExcludedSequenceMotifsDesignFilterResponse object { motifs, type }

motifs: array of string

Sequence motifs that must not occur. X matches any single residue.

type: "excluded_sequence_motifs"

idempotency_key: optional string

maxLength255

workspace_id: optional string

Workspace to run this redesign in.

livemode: boolean

Whether this resource was created with a live API key.

pipeline: "boltz-protein-redesign"

pipeline_version: "v2026-07-14"

progress: object { num_proteins_generated, total_proteins_to_generate, latest_result_id }

num_proteins_generated: number

Number of protein binders generated so far

minimum0

total_proteins_to_generate: number

Total number of protein binders requested

minimum1

latest_result_id: optional string

ID of the most recently generated result

started_at: string

formatdate-time

status: "pending" or "running" or "succeeded" or 2 more

One of the following:

"pending"

"running"

"succeeded"

"failed"

"stopped"

stopped_at: string

formatdate-time

workspace_id: string

Workspace ID

idempotency_key: optional string

Client-provided idempotency key

SequenceRedesignListResponse object { id, completed_at, created_at, 13 more }

Summary of a protein sequence redesign run.

id: string

Unique ProteinSequenceRedesignRunSummary identifier

completed_at: string

formatdate-time

created_at: string

formatdate-time

data_deleted_at: string

When the input, output, and result data was permanently deleted. Null if data has not been deleted.

formatdate-time

Deprecatedengine: "boltz-protein-redesign"

Use pipeline instead.

Deprecated. Use pipeline instead.

Deprecatedengine_version: "v2026-07-14"

Use pipeline_version instead.

Deprecated. Use pipeline_version instead.

error: object { code, message, details }

code: string

Machine-readable error code

message: string

Human-readable error message

details: optional unknown

Additional field-level error details keyed by input path, when available.

livemode: boolean

Whether this resource was created with a live API key.

pipeline: "boltz-protein-redesign"

pipeline_version: "v2026-07-14"

progress: object { num_proteins_generated, total_proteins_to_generate, latest_result_id }

num_proteins_generated: number

Number of protein binders generated so far

minimum0

total_proteins_to_generate: number

Total number of protein binders requested

minimum1

latest_result_id: optional string

ID of the most recently generated result

started_at: string

formatdate-time

status: "pending" or "running" or "succeeded" or 2 more

One of the following:

"pending"

"running"

"succeeded"

"failed"

"stopped"

stopped_at: string

formatdate-time

workspace_id: string

Workspace ID

idempotency_key: optional string

Client-provided idempotency key

SequenceRedesignRetrieveResponse object { id, completed_at, created_at, 14 more }

A fixed-structure protein sequence redesign run.

id: string

Unique ProteinSequenceRedesignRun identifier

completed_at: string

formatdate-time

created_at: string

formatdate-time

data_deleted_at: string

When the input, output, and result data was permanently deleted. Null if data has not been deleted.

formatdate-time

Deprecatedengine: "boltz-protein-redesign"

Use pipeline instead.

Deprecated. Use pipeline instead.

Deprecatedengine_version: "v2026-07-14"

Use pipeline_version instead.

Deprecated. Use pipeline_version instead.

error: object { code, message, details }

code: string

Machine-readable error code

message: string

Human-readable error message

details: optional unknown

Additional field-level error details keyed by input path, when available.

input: object { entities, num_proteins, structure, 4 more } or object { entities, num_proteins, structure, 4 more }

Pipeline input (null if data deleted)

One of the following:

BinderProteinSequenceRedesignRunInputResponse object { entities, num_proteins, structure, 4 more }

entities: array of object { chain_id, role, type } or object { chain_id, role, type, design_motifs }

Every chain in the input CIF, assigned exactly once as target or binder.

One of the following:

BinderSequenceRedesignTargetEntityResponse object { chain_id, role, type }

A fixed target chain from the input CIF.

chain_id: string

minLength1

role: "target"

type: "from_template"

BinderSequenceRedesignBinderEntityResponse object { chain_id, role, type, design_motifs }

chain_id: string

minLength1

role: "binder"

type: "from_template"

design_motifs: optional array of object { filters, residues, type }

Residues to redesign. Omit this field to keep the binder chain fixed.

filters: array of object { amino_acids, type } or object { max_fraction, type } or object { motifs, type }

Filters applied to this motif in addition to global_design_filters.

One of the following:

ExcludedAminoAcidsDesignFilterResponse object { amino_acids, type }

amino_acids: array of string

Single-letter amino-acid codes that must not occur in the filtered designed region.

type: "excluded_amino_acids"

MaxHydrophobicFractionDesignFilterResponse object { max_fraction, type }

max_fraction: number

minimum0

maximum1

type: "max_hydrophobic_fraction"

ExcludedSequenceMotifsDesignFilterResponse object { motifs, type }

motifs: array of string

Sequence motifs that must not occur. X matches any single residue.

type: "excluded_sequence_motifs"

residues: array of number

0-indexed residues to redesign on this chain.

type: "residues"

num_proteins: number

Number of unique filter-passing redesigned proteins to generate.

minimum1

maximum1000

structure: object { url, url_expires_at }

url: string

URL to download the file

formaturi

url_expires_at: string

When the presigned URL expires

formatdate-time

type: "binder"

global_design_filters: optional array of object { amino_acids, type } or object { max_fraction, type } or object { motifs, type }

Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters.

One of the following:

ExcludedAminoAcidsDesignFilterResponse object { amino_acids, type }

amino_acids: array of string

Single-letter amino-acid codes that must not occur in the filtered designed region.

type: "excluded_amino_acids"

MaxHydrophobicFractionDesignFilterResponse object { max_fraction, type }

max_fraction: number

minimum0

maximum1

type: "max_hydrophobic_fraction"

ExcludedSequenceMotifsDesignFilterResponse object { motifs, type }

motifs: array of string

Sequence motifs that must not occur. X matches any single residue.

type: "excluded_sequence_motifs"

idempotency_key: optional string

maxLength255

workspace_id: optional string

Workspace to run this redesign in.

GenericProteinSequenceRedesignRunInputResponse object { entities, num_proteins, structure, 4 more }

entities: array of object { chain_id, type, design_motifs }

Every chain in the input CIF, assigned exactly once.

chain_id: string

minLength1

type: "from_template"

design_motifs: optional array of object { filters, residues, type }

Residues to redesign. Omit this field to keep the chain fixed.

filters: array of object { amino_acids, type } or object { max_fraction, type } or object { motifs, type }

Filters applied to this motif in addition to global_design_filters.

One of the following:

ExcludedAminoAcidsDesignFilterResponse object { amino_acids, type }

amino_acids: array of string

Single-letter amino-acid codes that must not occur in the filtered designed region.

type: "excluded_amino_acids"

MaxHydrophobicFractionDesignFilterResponse object { max_fraction, type }

max_fraction: number

minimum0

maximum1

type: "max_hydrophobic_fraction"

ExcludedSequenceMotifsDesignFilterResponse object { motifs, type }

motifs: array of string

Sequence motifs that must not occur. X matches any single residue.

type: "excluded_sequence_motifs"

residues: array of number

0-indexed residues to redesign on this chain.

type: "residues"

num_proteins: number

Number of unique filter-passing redesigned proteins to generate.

minimum1

maximum1000

structure: object { url, url_expires_at }

url: string

URL to download the file

formaturi

url_expires_at: string

When the presigned URL expires

formatdate-time

type: "generic"

global_design_filters: optional array of object { amino_acids, type } or object { max_fraction, type } or object { motifs, type }

Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters.

One of the following:

ExcludedAminoAcidsDesignFilterResponse object { amino_acids, type }

amino_acids: array of string

Single-letter amino-acid codes that must not occur in the filtered designed region.

type: "excluded_amino_acids"

MaxHydrophobicFractionDesignFilterResponse object { max_fraction, type }

max_fraction: number

minimum0

maximum1

type: "max_hydrophobic_fraction"

ExcludedSequenceMotifsDesignFilterResponse object { motifs, type }

motifs: array of string

Sequence motifs that must not occur. X matches any single residue.

type: "excluded_sequence_motifs"

idempotency_key: optional string

maxLength255

workspace_id: optional string

Workspace to run this redesign in.

livemode: boolean

Whether this resource was created with a live API key.

pipeline: "boltz-protein-redesign"

pipeline_version: "v2026-07-14"

progress: object { num_proteins_generated, total_proteins_to_generate, latest_result_id }

num_proteins_generated: number

Number of protein binders generated so far

minimum0

total_proteins_to_generate: number

Total number of protein binders requested

minimum1

latest_result_id: optional string

ID of the most recently generated result

started_at: string

formatdate-time

status: "pending" or "running" or "succeeded" or 2 more

One of the following:

"pending"

"running"

"succeeded"

"failed"

"stopped"

stopped_at: string

formatdate-time

workspace_id: string

Workspace ID

idempotency_key: optional string

Client-provided idempotency key

SequenceRedesignListResultsResponse = object { id, artifacts, created_at, 4 more } or object { id, artifacts, created_at, 4 more }

One of the following:

BinderProteinDesignResult object { id, artifacts, created_at, 4 more }

id: string

Unique result ID.

artifacts: object { archive, structure }

archive: object { url, url_expires_at }

url: string

URL to download the file

formaturi

url_expires_at: string

When the presigned URL expires

formatdate-time

structure: optional object { url, url_expires_at }

url: string

URL to download the file

formaturi

url_expires_at: string

When the presigned URL expires

formatdate-time

created_at: string

formatdate-time

entities: array of object { chain_ids, type, value, 2 more } or object { chain_ids, type, value, 2 more } or object { chain_ids, type, value, 2 more } or 2 more

Entities in the designed complex, including designed and fixed input entities.

One of the following:

ProteinEntity object { chain_ids, type, value, 2 more }

chain_ids: array of string

Chain IDs for this entity

type: "protein"

value: string

Amino acid sequence (one-letter codes)

cyclic: optional boolean

Whether the sequence is cyclic

modifications: optional array of object { residue_index, type, value }

CCD post-translational modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported.

residue_index: number

0-based index of the residue to modify

minimum0

type: "ccd"

Modification format. Only CCD polymer modifications are supported.

value: string

CCD code from RCSB PDB (e.g. ‘MSE’ for selenomethionine, ‘SEP’ for phosphoserine)

RnaEntity object { chain_ids, type, value, 2 more }

chain_ids: array of string

Chain IDs for this entity

type: "rna"

value: string

RNA nucleotide sequence (A, C, G, U, N)

cyclic: optional boolean

Whether the sequence is cyclic

modifications: optional array of object { residue_index, type, value }

CCD chemical modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported.

residue_index: number

0-based index of the residue to modify

minimum0

type: "ccd"

Modification format. Only CCD polymer modifications are supported.

value: string

CCD code from RCSB PDB (e.g. ‘MSE’ for selenomethionine, ‘SEP’ for phosphoserine)

DnaEntity object { chain_ids, type, value, 2 more }

chain_ids: array of string

Chain IDs for this entity

type: "dna"

value: string

DNA nucleotide sequence (A, C, G, T, N)

cyclic: optional boolean

Whether the sequence is cyclic

modifications: optional array of object { residue_index, type, value }

CCD chemical modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported.

residue_index: number

0-based index of the residue to modify

minimum0

type: "ccd"

Modification format. Only CCD polymer modifications are supported.

value: string

CCD code from RCSB PDB (e.g. ‘MSE’ for selenomethionine, ‘SEP’ for phosphoserine)

LigandCcdEntity object { chain_ids, type, value }

chain_ids: array of string

Chain IDs for this ligand

type: "ligand_ccd"

value: string

CCD code (e.g., ATP, ADP)

LigandSmilesEntity object { chain_ids, type, value }

chain_ids: array of string

Chain IDs for this ligand

type: "ligand_smiles"

value: string

SMILES string representing the ligand

metrics: object { binding_confidence, helix_fraction, iptm, 4 more }

Structural and binding quality metrics for a designed protein binder

binding_confidence: number

Confidence that the designed binder binds the target (0-1). Primary metric for hit discovery.

helix_fraction: number

Fraction of the designed sequence forming alpha helices (0-1).

minimum0

maximum1

iptm: number

Interface predicted TM score (0-1). Confidence in the protein-protein interface.

loop_fraction: number

Fraction of the designed sequence in coil/loop regions (0-1).

minimum0

maximum1

min_interaction_pae: number

Minimum predicted aligned error at the interface (Angstroms). Lower values indicate higher confidence.

sheet_fraction: number

Fraction of the designed sequence forming beta sheets (0-1).

minimum0

maximum1

structure_confidence: number

Confidence in the predicted 3D structure (0-1).

type: "binder"

warnings: optional array of object { code, message }

Warnings about potential quality issues with this result.

code: string

Machine-readable warning code (e.g. “low_confidence”, “unusual_geometry”)

message: string

Human-readable description of the warning

GenericProteinDesignResult object { id, artifacts, created_at, 4 more }

id: string

Unique result ID.

artifacts: object { archive, structure }

archive: object { url, url_expires_at }

url: string

URL to download the file

formaturi

url_expires_at: string

When the presigned URL expires

formatdate-time

structure: optional object { url, url_expires_at }

url: string

URL to download the file

formaturi

url_expires_at: string

When the presigned URL expires

formatdate-time

created_at: string

formatdate-time

entities: array of object { chain_ids, type, value, 2 more } or object { chain_ids, type, value, 2 more } or object { chain_ids, type, value, 2 more } or 2 more

Entities in the designed complex, including designed and fixed input entities.

One of the following:

ProteinEntity object { chain_ids, type, value, 2 more }

chain_ids: array of string

Chain IDs for this entity

type: "protein"

value: string

Amino acid sequence (one-letter codes)

cyclic: optional boolean

Whether the sequence is cyclic

modifications: optional array of object { residue_index, type, value }

CCD post-translational modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported.

residue_index: number

0-based index of the residue to modify

minimum0

type: "ccd"

Modification format. Only CCD polymer modifications are supported.

value: string

CCD code from RCSB PDB (e.g. ‘MSE’ for selenomethionine, ‘SEP’ for phosphoserine)

RnaEntity object { chain_ids, type, value, 2 more }

chain_ids: array of string

Chain IDs for this entity

type: "rna"

value: string

RNA nucleotide sequence (A, C, G, U, N)

cyclic: optional boolean

Whether the sequence is cyclic

modifications: optional array of object { residue_index, type, value }

CCD chemical modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported.

residue_index: number

0-based index of the residue to modify

minimum0

type: "ccd"

Modification format. Only CCD polymer modifications are supported.

value: string

CCD code from RCSB PDB (e.g. ‘MSE’ for selenomethionine, ‘SEP’ for phosphoserine)

DnaEntity object { chain_ids, type, value, 2 more }

chain_ids: array of string

Chain IDs for this entity

type: "dna"

value: string

DNA nucleotide sequence (A, C, G, T, N)

cyclic: optional boolean

Whether the sequence is cyclic

modifications: optional array of object { residue_index, type, value }

CCD chemical modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported.

residue_index: number

0-based index of the residue to modify

minimum0

type: "ccd"

Modification format. Only CCD polymer modifications are supported.

value: string

CCD code from RCSB PDB (e.g. ‘MSE’ for selenomethionine, ‘SEP’ for phosphoserine)

LigandCcdEntity object { chain_ids, type, value }

chain_ids: array of string

Chain IDs for this ligand

type: "ligand_ccd"

value: string

CCD code (e.g., ATP, ADP)

LigandSmilesEntity object { chain_ids, type, value }

chain_ids: array of string

Chain IDs for this ligand

type: "ligand_smiles"

value: string

SMILES string representing the ligand

metrics: object { helix_fraction, loop_fraction, sheet_fraction, structure_confidence }

Structure and design-quality metrics for a generic protein design.

helix_fraction: number

Fraction of the designed sequence forming alpha helices (0-1).

minimum0

maximum1

loop_fraction: number

Fraction of the designed sequence in coil/loop regions (0-1).

minimum0

maximum1

sheet_fraction: number

Fraction of the designed sequence forming beta sheets (0-1).

minimum0

maximum1

structure_confidence: number

Confidence in the predicted 3D structure (0-1).

type: "generic"

warnings: optional array of object { code, message }

Warnings about potential quality issues with this result.

code: string

Machine-readable warning code (e.g. “low_confidence”, “unusual_geometry”)

message: string

Human-readable description of the warning

SequenceRedesignStopResponse object { id, completed_at, created_at, 14 more }

A fixed-structure protein sequence redesign run.

id: string

Unique ProteinSequenceRedesignRun identifier

completed_at: string

formatdate-time

created_at: string

formatdate-time

data_deleted_at: string

When the input, output, and result data was permanently deleted. Null if data has not been deleted.

formatdate-time

Deprecatedengine: "boltz-protein-redesign"

Use pipeline instead.

Deprecated. Use pipeline instead.

Deprecatedengine_version: "v2026-07-14"

Use pipeline_version instead.

Deprecated. Use pipeline_version instead.

error: object { code, message, details }

code: string

Machine-readable error code

message: string

Human-readable error message

details: optional unknown

Additional field-level error details keyed by input path, when available.

input: object { entities, num_proteins, structure, 4 more } or object { entities, num_proteins, structure, 4 more }

Pipeline input (null if data deleted)

One of the following:

BinderProteinSequenceRedesignRunInputResponse object { entities, num_proteins, structure, 4 more }

entities: array of object { chain_id, role, type } or object { chain_id, role, type, design_motifs }

Every chain in the input CIF, assigned exactly once as target or binder.

One of the following:

BinderSequenceRedesignTargetEntityResponse object { chain_id, role, type }

A fixed target chain from the input CIF.

chain_id: string

minLength1

role: "target"

type: "from_template"

BinderSequenceRedesignBinderEntityResponse object { chain_id, role, type, design_motifs }

chain_id: string

minLength1

role: "binder"

type: "from_template"

design_motifs: optional array of object { filters, residues, type }

Residues to redesign. Omit this field to keep the binder chain fixed.

filters: array of object { amino_acids, type } or object { max_fraction, type } or object { motifs, type }

Filters applied to this motif in addition to global_design_filters.

One of the following:

ExcludedAminoAcidsDesignFilterResponse object { amino_acids, type }

amino_acids: array of string

Single-letter amino-acid codes that must not occur in the filtered designed region.

type: "excluded_amino_acids"

MaxHydrophobicFractionDesignFilterResponse object { max_fraction, type }

max_fraction: number

minimum0

maximum1

type: "max_hydrophobic_fraction"

ExcludedSequenceMotifsDesignFilterResponse object { motifs, type }

motifs: array of string

Sequence motifs that must not occur. X matches any single residue.

type: "excluded_sequence_motifs"

residues: array of number

0-indexed residues to redesign on this chain.

type: "residues"

num_proteins: number

Number of unique filter-passing redesigned proteins to generate.

minimum1

maximum1000

structure: object { url, url_expires_at }

url: string

URL to download the file

formaturi

url_expires_at: string

When the presigned URL expires

formatdate-time

type: "binder"

global_design_filters: optional array of object { amino_acids, type } or object { max_fraction, type } or object { motifs, type }

Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters.

One of the following:

ExcludedAminoAcidsDesignFilterResponse object { amino_acids, type }

amino_acids: array of string

Single-letter amino-acid codes that must not occur in the filtered designed region.

type: "excluded_amino_acids"

MaxHydrophobicFractionDesignFilterResponse object { max_fraction, type }

max_fraction: number

minimum0

maximum1

type: "max_hydrophobic_fraction"

ExcludedSequenceMotifsDesignFilterResponse object { motifs, type }

motifs: array of string

Sequence motifs that must not occur. X matches any single residue.

type: "excluded_sequence_motifs"

idempotency_key: optional string

maxLength255

workspace_id: optional string

Workspace to run this redesign in.

GenericProteinSequenceRedesignRunInputResponse object { entities, num_proteins, structure, 4 more }

entities: array of object { chain_id, type, design_motifs }

Every chain in the input CIF, assigned exactly once.

chain_id: string

minLength1

type: "from_template"

design_motifs: optional array of object { filters, residues, type }

Residues to redesign. Omit this field to keep the chain fixed.

filters: array of object { amino_acids, type } or object { max_fraction, type } or object { motifs, type }

Filters applied to this motif in addition to global_design_filters.

One of the following:

ExcludedAminoAcidsDesignFilterResponse object { amino_acids, type }

amino_acids: array of string

Single-letter amino-acid codes that must not occur in the filtered designed region.

type: "excluded_amino_acids"

MaxHydrophobicFractionDesignFilterResponse object { max_fraction, type }

max_fraction: number

minimum0

maximum1

type: "max_hydrophobic_fraction"

ExcludedSequenceMotifsDesignFilterResponse object { motifs, type }

motifs: array of string

Sequence motifs that must not occur. X matches any single residue.

type: "excluded_sequence_motifs"

residues: array of number

0-indexed residues to redesign on this chain.

type: "residues"

num_proteins: number

Number of unique filter-passing redesigned proteins to generate.

minimum1

maximum1000

structure: object { url, url_expires_at }

url: string

URL to download the file

formaturi

url_expires_at: string

When the presigned URL expires

formatdate-time

type: "generic"

global_design_filters: optional array of object { amino_acids, type } or object { max_fraction, type } or object { motifs, type }

Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters.

One of the following:

ExcludedAminoAcidsDesignFilterResponse object { amino_acids, type }

amino_acids: array of string

Single-letter amino-acid codes that must not occur in the filtered designed region.

type: "excluded_amino_acids"

MaxHydrophobicFractionDesignFilterResponse object { max_fraction, type }

max_fraction: number

minimum0

maximum1

type: "max_hydrophobic_fraction"

ExcludedSequenceMotifsDesignFilterResponse object { motifs, type }

motifs: array of string

Sequence motifs that must not occur. X matches any single residue.

type: "excluded_sequence_motifs"

idempotency_key: optional string

maxLength255

workspace_id: optional string

Workspace to run this redesign in.

livemode: boolean

Whether this resource was created with a live API key.

pipeline: "boltz-protein-redesign"

pipeline_version: "v2026-07-14"

progress: object { num_proteins_generated, total_proteins_to_generate, latest_result_id }

num_proteins_generated: number

Number of protein binders generated so far

minimum0

total_proteins_to_generate: number

Total number of protein binders requested

minimum1

latest_result_id: optional string

ID of the most recently generated result

started_at: string

formatdate-time

status: "pending" or "running" or "succeeded" or 2 more

One of the following:

"pending"

"running"

"succeeded"

"failed"

"stopped"

stopped_at: string

formatdate-time

workspace_id: string

Workspace ID

idempotency_key: optional string

Client-provided idempotency key

SequenceRedesignResumeResponse object { id, completed_at, created_at, 14 more }

A fixed-structure protein sequence redesign run.

id: string

Unique ProteinSequenceRedesignRun identifier

completed_at: string

formatdate-time

created_at: string

formatdate-time

data_deleted_at: string

When the input, output, and result data was permanently deleted. Null if data has not been deleted.

formatdate-time

Deprecatedengine: "boltz-protein-redesign"

Use pipeline instead.

Deprecated. Use pipeline instead.

Deprecatedengine_version: "v2026-07-14"

Use pipeline_version instead.

Deprecated. Use pipeline_version instead.

error: object { code, message, details }

code: string

Machine-readable error code

message: string

Human-readable error message

details: optional unknown

Additional field-level error details keyed by input path, when available.

input: object { entities, num_proteins, structure, 4 more } or object { entities, num_proteins, structure, 4 more }

Pipeline input (null if data deleted)

One of the following:

BinderProteinSequenceRedesignRunInputResponse object { entities, num_proteins, structure, 4 more }

entities: array of object { chain_id, role, type } or object { chain_id, role, type, design_motifs }

Every chain in the input CIF, assigned exactly once as target or binder.

One of the following:

BinderSequenceRedesignTargetEntityResponse object { chain_id, role, type }

A fixed target chain from the input CIF.

chain_id: string

minLength1

role: "target"

type: "from_template"

BinderSequenceRedesignBinderEntityResponse object { chain_id, role, type, design_motifs }

chain_id: string

minLength1

role: "binder"

type: "from_template"

design_motifs: optional array of object { filters, residues, type }

Residues to redesign. Omit this field to keep the binder chain fixed.

filters: array of object { amino_acids, type } or object { max_fraction, type } or object { motifs, type }

Filters applied to this motif in addition to global_design_filters.

One of the following:

ExcludedAminoAcidsDesignFilterResponse object { amino_acids, type }

amino_acids: array of string

Single-letter amino-acid codes that must not occur in the filtered designed region.

type: "excluded_amino_acids"

MaxHydrophobicFractionDesignFilterResponse object { max_fraction, type }

max_fraction: number

minimum0

maximum1

type: "max_hydrophobic_fraction"

ExcludedSequenceMotifsDesignFilterResponse object { motifs, type }

motifs: array of string

Sequence motifs that must not occur. X matches any single residue.

type: "excluded_sequence_motifs"

residues: array of number

0-indexed residues to redesign on this chain.

type: "residues"

num_proteins: number

Number of unique filter-passing redesigned proteins to generate.

minimum1

maximum1000

structure: object { url, url_expires_at }

url: string

URL to download the file

formaturi

url_expires_at: string

When the presigned URL expires

formatdate-time

type: "binder"

global_design_filters: optional array of object { amino_acids, type } or object { max_fraction, type } or object { motifs, type }

Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters.

One of the following:

ExcludedAminoAcidsDesignFilterResponse object { amino_acids, type }

amino_acids: array of string

Single-letter amino-acid codes that must not occur in the filtered designed region.

type: "excluded_amino_acids"

MaxHydrophobicFractionDesignFilterResponse object { max_fraction, type }

max_fraction: number

minimum0

maximum1

type: "max_hydrophobic_fraction"

ExcludedSequenceMotifsDesignFilterResponse object { motifs, type }

motifs: array of string

Sequence motifs that must not occur. X matches any single residue.

type: "excluded_sequence_motifs"

idempotency_key: optional string

maxLength255

workspace_id: optional string

Workspace to run this redesign in.

GenericProteinSequenceRedesignRunInputResponse object { entities, num_proteins, structure, 4 more }

entities: array of object { chain_id, type, design_motifs }

Every chain in the input CIF, assigned exactly once.

chain_id: string

minLength1

type: "from_template"

design_motifs: optional array of object { filters, residues, type }

Residues to redesign. Omit this field to keep the chain fixed.

filters: array of object { amino_acids, type } or object { max_fraction, type } or object { motifs, type }

Filters applied to this motif in addition to global_design_filters.

One of the following:

ExcludedAminoAcidsDesignFilterResponse object { amino_acids, type }

amino_acids: array of string

Single-letter amino-acid codes that must not occur in the filtered designed region.

type: "excluded_amino_acids"

MaxHydrophobicFractionDesignFilterResponse object { max_fraction, type }

max_fraction: number

minimum0

maximum1

type: "max_hydrophobic_fraction"

ExcludedSequenceMotifsDesignFilterResponse object { motifs, type }

motifs: array of string

Sequence motifs that must not occur. X matches any single residue.

type: "excluded_sequence_motifs"

residues: array of number

0-indexed residues to redesign on this chain.

type: "residues"

num_proteins: number

Number of unique filter-passing redesigned proteins to generate.

minimum1

maximum1000

structure: object { url, url_expires_at }

url: string

URL to download the file

formaturi

url_expires_at: string

When the presigned URL expires

formatdate-time

type: "generic"

global_design_filters: optional array of object { amino_acids, type } or object { max_fraction, type } or object { motifs, type }

Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters.

One of the following:

ExcludedAminoAcidsDesignFilterResponse object { amino_acids, type }

amino_acids: array of string

Single-letter amino-acid codes that must not occur in the filtered designed region.

type: "excluded_amino_acids"

MaxHydrophobicFractionDesignFilterResponse object { max_fraction, type }

max_fraction: number

minimum0

maximum1

type: "max_hydrophobic_fraction"

ExcludedSequenceMotifsDesignFilterResponse object { motifs, type }

motifs: array of string

Sequence motifs that must not occur. X matches any single residue.

type: "excluded_sequence_motifs"

idempotency_key: optional string

maxLength255

workspace_id: optional string

Workspace to run this redesign in.

livemode: boolean

Whether this resource was created with a live API key.

pipeline: "boltz-protein-redesign"

pipeline_version: "v2026-07-14"

progress: object { num_proteins_generated, total_proteins_to_generate, latest_result_id }

num_proteins_generated: number

Number of protein binders generated so far

minimum0

total_proteins_to_generate: number

Total number of protein binders requested

minimum1

latest_result_id: optional string

ID of the most recently generated result

started_at: string

formatdate-time

status: "pending" or "running" or "succeeded" or 2 more

One of the following:

"pending"

"running"

"succeeded"

"failed"

"stopped"

stopped_at: string

formatdate-time

workspace_id: string

Workspace ID

idempotency_key: optional string

Client-provided idempotency key

SequenceRedesignDeleteDataResponse object { id, data_deleted, data_deleted_at }

id: string

ID of the resource whose data was deleted

data_deleted: true

data_deleted_at: string

When the data was deleted

formatdate-time

SequenceRedesignEstimateCostResponse object { breakdown, disclaimer, estimated_cost_usd }

Estimate response with monetary values encoded as decimal strings to preserve precision.

breakdown: object { application, cost_per_unit_usd, num_units }

Cost breakdown for the billed application.

application: "structure_and_binding" or "small_molecule_design" or "small_molecule_library_screen" or 4 more

One of the following:

"structure_and_binding"

"small_molecule_design"

"small_molecule_library_screen"

"protein_design"

"protein_redesign"

"protein_library_screen"

"adme"

cost_per_unit_usd: string

Estimated cost per displayed unit as a decimal string, rounded up to 4 decimal places. This may include token-size multipliers or generation overhead; estimated_cost_usd is the authoritative total.

num_units: number

Number of billable units in the estimate. The unit depends on the endpoint: samples for structure-and-binding, molecules for ADME, and requested proteins or molecules for design/screen endpoints.

disclaimer: string

estimated_cost_usd: string

Estimated total cost as a decimal string