# Sequence Redesign ## Start a protein sequence redesign run `client.Protein.SequenceRedesign.Start(ctx, body) (*ProteinSequenceRedesignStartResponse, error)` **post** `/compute/v1/protein/sequence-redesign` Create a protein sequence redesign run from selected residues in a fixed input structure ### Parameters - `body ProteinSequenceRedesignStartParams` - `Entities param.Field[[]ProteinSequenceRedesignStartParamsBinderProteinSequenceRedesignRunInputEntityUnion]` Every chain in the input CIF, assigned exactly once as target or binder. - `ProteinSequenceRedesignStartParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignTargetEntity` - `ChainID string` - `Role Target` - `const TargetTarget Target = "target"` - `Type FromTemplate` - `const FromTemplateFromTemplate FromTemplate = "from_template"` - `ProteinSequenceRedesignStartParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignBinderEntity` - `ChainID string` - `Role Binder` - `const BinderBinder Binder = "binder"` - `Type FromTemplate` - `const FromTemplateFromTemplate FromTemplate = "from_template"` - `DesignMotifs []ProteinSequenceRedesignStartParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignBinderEntityDesignMotif` Residues to redesign. Omit this field to keep the binder chain fixed. - `Filters []ProteinSequenceRedesignStartParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignBinderEntityDesignMotifFilterUnion` Filters applied to this motif in addition to global_design_filters. - `ProteinSequenceRedesignStartParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignBinderEntityDesignMotifFilterExcludedAminoAcidsDesignFilter` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `ProteinSequenceRedesignStartParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignBinderEntityDesignMotifFilterMaxHydrophobicFractionDesignFilter` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `ProteinSequenceRedesignStartParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignBinderEntityDesignMotifFilterExcludedSequenceMotifsDesignFilter` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `Residues []int64` 0-indexed residues to redesign on this chain. - `Type Residues` - `const ResiduesResidues Residues = "residues"` - `NumProteins param.Field[int64]` Number of unique filter-passing redesigned proteins to generate. - `Structure param.Field[ProteinSequenceRedesignStartParamsBinderProteinSequenceRedesignRunInputStructureUnion]` How to provide a CIF structure file. URLs are auto-detected; base64 uploads must use chemical/x-cif media type. - `ProteinSequenceRedesignStartParamsBinderProteinSequenceRedesignRunInputStructureURLSource` - `Type URL` - `const URLURL URL = "url"` - `URL string` - `ProteinSequenceRedesignStartParamsBinderProteinSequenceRedesignRunInputStructureCifBase64Source` - `Data string` Base64-encoded CIF file contents - `MediaType ChemicalXCif` Must be chemical/x-cif for CIF files - `const ChemicalXCifChemicalXCif ChemicalXCif = "chemical/x-cif"` - `Type Base64` - `const Base64Base64 Base64 = "base64"` - `Type param.Field[Binder]` - `const BinderBinder Binder = "binder"` - `GlobalDesignFilters param.Field[[]ProteinSequenceRedesignStartParamsBinderProteinSequenceRedesignRunInputGlobalDesignFilterUnion]` Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters. - `ProteinSequenceRedesignStartParamsBinderProteinSequenceRedesignRunInputGlobalDesignFilterExcludedAminoAcidsDesignFilter` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `ProteinSequenceRedesignStartParamsBinderProteinSequenceRedesignRunInputGlobalDesignFilterMaxHydrophobicFractionDesignFilter` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `ProteinSequenceRedesignStartParamsBinderProteinSequenceRedesignRunInputGlobalDesignFilterExcludedSequenceMotifsDesignFilter` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `IdempotencyKey param.Field[string]` - `WorkspaceID param.Field[string]` Workspace to run this redesign in. ### Returns - `type ProteinSequenceRedesignStartResponse struct{…}` A fixed-structure protein sequence redesign run. - `ID string` Unique ProteinSequenceRedesignRun identifier - `CompletedAt Time` - `CreatedAt Time` - `DataDeletedAt Time` When the input, output, and result data was permanently deleted. Null if data has not been deleted. - `Engine BoltzProteinRedesign` Deprecated. Use pipeline instead. - `const BoltzProteinRedesignBoltzProteinRedesign BoltzProteinRedesign = "boltz-protein-redesign"` - `EngineVersion V2026_07_14` Deprecated. Use pipeline_version instead. - `const V2026_07_14V2026_07_14 V2026_07_14 = "v2026-07-14"` - `Error ProteinSequenceRedesignStartResponseError` - `Code string` Machine-readable error code - `Message string` Human-readable error message - `Details any` Additional field-level error details keyed by input path, when available. - `Input ProteinSequenceRedesignStartResponseInputUnion` Pipeline input (null if data deleted) - `type ProteinSequenceRedesignStartResponseInputBinderProteinSequenceRedesignRunInputResponse struct{…}` - `Entities []ProteinSequenceRedesignStartResponseInputBinderProteinSequenceRedesignRunInputResponseEntityUnion` Every chain in the input CIF, assigned exactly once as target or binder. - `type ProteinSequenceRedesignStartResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignTargetEntityResponse struct{…}` A fixed target chain from the input CIF. - `ChainID string` - `Role Target` - `const TargetTarget Target = "target"` - `Type FromTemplate` - `const FromTemplateFromTemplate FromTemplate = "from_template"` - `type ProteinSequenceRedesignStartResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponse struct{…}` - `ChainID string` - `Role Binder` - `const BinderBinder Binder = "binder"` - `Type FromTemplate` - `const FromTemplateFromTemplate FromTemplate = "from_template"` - `DesignMotifs []ProteinSequenceRedesignStartResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotif` Residues to redesign. Omit this field to keep the binder chain fixed. - `Filters []ProteinSequenceRedesignStartResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotifFilterUnion` Filters applied to this motif in addition to global_design_filters. - `type ProteinSequenceRedesignStartResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotifFilterExcludedAminoAcidsDesignFilterResponse struct{…}` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `type ProteinSequenceRedesignStartResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotifFilterMaxHydrophobicFractionDesignFilterResponse struct{…}` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `type ProteinSequenceRedesignStartResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotifFilterExcludedSequenceMotifsDesignFilterResponse struct{…}` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `Residues []int64` 0-indexed residues to redesign on this chain. - `Type Residues` - `const ResiduesResidues Residues = "residues"` - `NumProteins int64` Number of unique filter-passing redesigned proteins to generate. - `Structure ProteinSequenceRedesignStartResponseInputBinderProteinSequenceRedesignRunInputResponseStructure` - `URL string` URL to download the file - `URLExpiresAt Time` When the presigned URL expires - `Type Binder` - `const BinderBinder Binder = "binder"` - `GlobalDesignFilters []ProteinSequenceRedesignStartResponseInputBinderProteinSequenceRedesignRunInputResponseGlobalDesignFilterUnion` Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters. - `type ProteinSequenceRedesignStartResponseInputBinderProteinSequenceRedesignRunInputResponseGlobalDesignFilterExcludedAminoAcidsDesignFilterResponse struct{…}` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `type ProteinSequenceRedesignStartResponseInputBinderProteinSequenceRedesignRunInputResponseGlobalDesignFilterMaxHydrophobicFractionDesignFilterResponse struct{…}` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `type ProteinSequenceRedesignStartResponseInputBinderProteinSequenceRedesignRunInputResponseGlobalDesignFilterExcludedSequenceMotifsDesignFilterResponse struct{…}` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `IdempotencyKey string` - `WorkspaceID string` Workspace to run this redesign in. - `type ProteinSequenceRedesignStartResponseInputGenericProteinSequenceRedesignRunInputResponse struct{…}` - `Entities []ProteinSequenceRedesignStartResponseInputGenericProteinSequenceRedesignRunInputResponseEntity` Every chain in the input CIF, assigned exactly once. - `ChainID string` - `Type FromTemplate` - `const FromTemplateFromTemplate FromTemplate = "from_template"` - `DesignMotifs []ProteinSequenceRedesignStartResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotif` Residues to redesign. Omit this field to keep the chain fixed. - `Filters []ProteinSequenceRedesignStartResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotifFilterUnion` Filters applied to this motif in addition to global_design_filters. - `type ProteinSequenceRedesignStartResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotifFilterExcludedAminoAcidsDesignFilterResponse struct{…}` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `type ProteinSequenceRedesignStartResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotifFilterMaxHydrophobicFractionDesignFilterResponse struct{…}` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `type ProteinSequenceRedesignStartResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotifFilterExcludedSequenceMotifsDesignFilterResponse struct{…}` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `Residues []int64` 0-indexed residues to redesign on this chain. - `Type Residues` - `const ResiduesResidues Residues = "residues"` - `NumProteins int64` Number of unique filter-passing redesigned proteins to generate. - `Structure ProteinSequenceRedesignStartResponseInputGenericProteinSequenceRedesignRunInputResponseStructure` - `URL string` URL to download the file - `URLExpiresAt Time` When the presigned URL expires - `Type Generic` - `const GenericGeneric Generic = "generic"` - `GlobalDesignFilters []ProteinSequenceRedesignStartResponseInputGenericProteinSequenceRedesignRunInputResponseGlobalDesignFilterUnion` Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters. - `type ProteinSequenceRedesignStartResponseInputGenericProteinSequenceRedesignRunInputResponseGlobalDesignFilterExcludedAminoAcidsDesignFilterResponse struct{…}` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `type ProteinSequenceRedesignStartResponseInputGenericProteinSequenceRedesignRunInputResponseGlobalDesignFilterMaxHydrophobicFractionDesignFilterResponse struct{…}` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `type ProteinSequenceRedesignStartResponseInputGenericProteinSequenceRedesignRunInputResponseGlobalDesignFilterExcludedSequenceMotifsDesignFilterResponse struct{…}` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `IdempotencyKey string` - `WorkspaceID string` Workspace to run this redesign in. - `Livemode bool` Whether this resource was created with a live API key. - `Pipeline BoltzProteinRedesign` - `const BoltzProteinRedesignBoltzProteinRedesign BoltzProteinRedesign = "boltz-protein-redesign"` - `PipelineVersion V2026_07_14` - `const V2026_07_14V2026_07_14 V2026_07_14 = "v2026-07-14"` - `Progress ProteinSequenceRedesignStartResponseProgress` - `NumProteinsGenerated int64` Number of protein binders generated so far - `TotalProteinsToGenerate int64` Total number of protein binders requested - `LatestResultID string` ID of the most recently generated result - `StartedAt Time` - `Status ProteinSequenceRedesignStartResponseStatus` - `const ProteinSequenceRedesignStartResponseStatusPending ProteinSequenceRedesignStartResponseStatus = "pending"` - `const ProteinSequenceRedesignStartResponseStatusRunning ProteinSequenceRedesignStartResponseStatus = "running"` - `const ProteinSequenceRedesignStartResponseStatusSucceeded ProteinSequenceRedesignStartResponseStatus = "succeeded"` - `const ProteinSequenceRedesignStartResponseStatusFailed ProteinSequenceRedesignStartResponseStatus = "failed"` - `const ProteinSequenceRedesignStartResponseStatusStopped ProteinSequenceRedesignStartResponseStatus = "stopped"` - `StoppedAt Time` - `WorkspaceID string` Workspace ID - `IdempotencyKey string` Client-provided idempotency key ### Example ```go package main import ( "context" "fmt" "github.com/boltz-bio/boltz-api-go" "github.com/boltz-bio/boltz-api-go/option" ) func main() { client := boltzapi.NewClient( option.WithAPIKey("My API Key"), ) response, err := client.Protein.SequenceRedesign.Start(context.TODO(), boltzapi.ProteinSequenceRedesignStartParams{ OfBinderProteinSequenceRedesignRunInput: &boltzapi.ProteinSequenceRedesignStartParamsBodyBinderProteinSequenceRedesignRunInput{ Entities: []boltzapi.ProteinSequenceRedesignStartParamsBodyBinderProteinSequenceRedesignRunInputEntityUnion{boltzapi.ProteinSequenceRedesignStartParamsBodyBinderProteinSequenceRedesignRunInputEntityUnion{ OfProteinSequenceRedesignStartsBodyBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignTargetEntity: &boltzapi.ProteinSequenceRedesignStartParamsBodyBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignTargetEntity{ ChainID: "x", }, }, boltzapi.ProteinSequenceRedesignStartParamsBodyBinderProteinSequenceRedesignRunInputEntityUnion{ OfProteinSequenceRedesignStartsBodyBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignTargetEntity: &boltzapi.ProteinSequenceRedesignStartParamsBodyBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignTargetEntity{ ChainID: "x", }, }}, NumProteins: 1, Structure: boltzapi.ProteinSequenceRedesignStartParamsBodyBinderProteinSequenceRedesignRunInputStructureUnion{ OfProteinSequenceRedesignStartsBodyBinderProteinSequenceRedesignRunInputStructureURLSource: &boltzapi.ProteinSequenceRedesignStartParamsBodyBinderProteinSequenceRedesignRunInputStructureURLSource{ URL: "https://example.com", }, }, }, }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.ID) } ``` #### Response ```json { "id": "id", "completed_at": "2019-12-27T18:11:19.117Z", "created_at": "2019-12-27T18:11:19.117Z", "data_deleted_at": "2019-12-27T18:11:19.117Z", "engine": "boltz-protein-redesign", "engine_version": "v2026-07-14", "error": { "code": "code", "message": "message", "details": {} }, "input": { "entities": [ { "chain_id": "x", "role": "target", "type": "from_template" }, { "chain_id": "x", "role": "target", "type": "from_template" } ], "num_proteins": 1, "structure": { "url": "https://example.com", "url_expires_at": "2019-12-27T18:11:19.117Z" }, "type": "binder", "global_design_filters": [ { "amino_acids": [ "x" ], "type": "excluded_amino_acids" } ], "idempotency_key": "idempotency_key", "workspace_id": "workspace_id" }, "livemode": true, "pipeline": "boltz-protein-redesign", "pipeline_version": "v2026-07-14", "progress": { "num_proteins_generated": 0, "total_proteins_to_generate": 1, "latest_result_id": "latest_result_id" }, "started_at": "2019-12-27T18:11:19.117Z", "status": "pending", "stopped_at": "2019-12-27T18:11:19.117Z", "workspace_id": "workspace_id", "idempotency_key": "idempotency_key" } ``` ## List protein sequence redesign runs `client.Protein.SequenceRedesign.List(ctx, query) (*CursorPage[ProteinSequenceRedesignListResponse], error)` **get** `/compute/v1/protein/sequence-redesign` List protein sequence redesign runs, optionally filtered by workspace ### Parameters - `query ProteinSequenceRedesignListParams` - `AfterID param.Field[string]` Return results after this ID - `BeforeID param.Field[string]` Return results before this ID - `Limit param.Field[int64]` Max items to return. Defaults to 100. - `WorkspaceID param.Field[string]` Filter by workspace ID. Only used with admin API keys. If not provided, defaults to the workspace associated with the API key, or the default workspace for admin keys. ### Returns - `type ProteinSequenceRedesignListResponse struct{…}` Summary of a protein sequence redesign run. - `ID string` Unique ProteinSequenceRedesignRunSummary identifier - `CompletedAt Time` - `CreatedAt Time` - `DataDeletedAt Time` When the input, output, and result data was permanently deleted. Null if data has not been deleted. - `Engine BoltzProteinRedesign` Deprecated. Use pipeline instead. - `const BoltzProteinRedesignBoltzProteinRedesign BoltzProteinRedesign = "boltz-protein-redesign"` - `EngineVersion V2026_07_14` Deprecated. Use pipeline_version instead. - `const V2026_07_14V2026_07_14 V2026_07_14 = "v2026-07-14"` - `Error ProteinSequenceRedesignListResponseError` - `Code string` Machine-readable error code - `Message string` Human-readable error message - `Details any` Additional field-level error details keyed by input path, when available. - `Livemode bool` Whether this resource was created with a live API key. - `Pipeline BoltzProteinRedesign` - `const BoltzProteinRedesignBoltzProteinRedesign BoltzProteinRedesign = "boltz-protein-redesign"` - `PipelineVersion V2026_07_14` - `const V2026_07_14V2026_07_14 V2026_07_14 = "v2026-07-14"` - `Progress ProteinSequenceRedesignListResponseProgress` - `NumProteinsGenerated int64` Number of protein binders generated so far - `TotalProteinsToGenerate int64` Total number of protein binders requested - `LatestResultID string` ID of the most recently generated result - `StartedAt Time` - `Status ProteinSequenceRedesignListResponseStatus` - `const ProteinSequenceRedesignListResponseStatusPending ProteinSequenceRedesignListResponseStatus = "pending"` - `const ProteinSequenceRedesignListResponseStatusRunning ProteinSequenceRedesignListResponseStatus = "running"` - `const ProteinSequenceRedesignListResponseStatusSucceeded ProteinSequenceRedesignListResponseStatus = "succeeded"` - `const ProteinSequenceRedesignListResponseStatusFailed ProteinSequenceRedesignListResponseStatus = "failed"` - `const ProteinSequenceRedesignListResponseStatusStopped ProteinSequenceRedesignListResponseStatus = "stopped"` - `StoppedAt Time` - `WorkspaceID string` Workspace ID - `IdempotencyKey string` Client-provided idempotency key ### Example ```go package main import ( "context" "fmt" "github.com/boltz-bio/boltz-api-go" "github.com/boltz-bio/boltz-api-go/option" ) func main() { client := boltzapi.NewClient( option.WithAPIKey("My API Key"), ) page, err := client.Protein.SequenceRedesign.List(context.TODO(), boltzapi.ProteinSequenceRedesignListParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` #### Response ```json { "data": [ { "id": "id", "completed_at": "2019-12-27T18:11:19.117Z", "created_at": "2019-12-27T18:11:19.117Z", "data_deleted_at": "2019-12-27T18:11:19.117Z", "engine": "boltz-protein-redesign", "engine_version": "v2026-07-14", "error": { "code": "code", "message": "message", "details": {} }, "livemode": true, "pipeline": "boltz-protein-redesign", "pipeline_version": "v2026-07-14", "progress": { "num_proteins_generated": 0, "total_proteins_to_generate": 1, "latest_result_id": "latest_result_id" }, "started_at": "2019-12-27T18:11:19.117Z", "status": "pending", "stopped_at": "2019-12-27T18:11:19.117Z", "workspace_id": "workspace_id", "idempotency_key": "idempotency_key" } ], "first_id": "first_id", "has_more": true, "last_id": "last_id" } ``` ## Get protein sequence redesign run status `client.Protein.SequenceRedesign.Get(ctx, id, query) (*ProteinSequenceRedesignGetResponse, error)` **get** `/compute/v1/protein/sequence-redesign/{id}` Retrieve a sequence redesign run by ID, including progress and status ### Parameters - `id string` - `query ProteinSequenceRedesignGetParams` - `WorkspaceID param.Field[string]` Workspace ID. Only used with admin API keys. Ignored (or validated) for workspace-scoped keys. ### Returns - `type ProteinSequenceRedesignGetResponse struct{…}` A fixed-structure protein sequence redesign run. - `ID string` Unique ProteinSequenceRedesignRun identifier - `CompletedAt Time` - `CreatedAt Time` - `DataDeletedAt Time` When the input, output, and result data was permanently deleted. Null if data has not been deleted. - `Engine BoltzProteinRedesign` Deprecated. Use pipeline instead. - `const BoltzProteinRedesignBoltzProteinRedesign BoltzProteinRedesign = "boltz-protein-redesign"` - `EngineVersion V2026_07_14` Deprecated. Use pipeline_version instead. - `const V2026_07_14V2026_07_14 V2026_07_14 = "v2026-07-14"` - `Error ProteinSequenceRedesignGetResponseError` - `Code string` Machine-readable error code - `Message string` Human-readable error message - `Details any` Additional field-level error details keyed by input path, when available. - `Input ProteinSequenceRedesignGetResponseInputUnion` Pipeline input (null if data deleted) - `type ProteinSequenceRedesignGetResponseInputBinderProteinSequenceRedesignRunInputResponse struct{…}` - `Entities []ProteinSequenceRedesignGetResponseInputBinderProteinSequenceRedesignRunInputResponseEntityUnion` Every chain in the input CIF, assigned exactly once as target or binder. - `type ProteinSequenceRedesignGetResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignTargetEntityResponse struct{…}` A fixed target chain from the input CIF. - `ChainID string` - `Role Target` - `const TargetTarget Target = "target"` - `Type FromTemplate` - `const FromTemplateFromTemplate FromTemplate = "from_template"` - `type ProteinSequenceRedesignGetResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponse struct{…}` - `ChainID string` - `Role Binder` - `const BinderBinder Binder = "binder"` - `Type FromTemplate` - `const FromTemplateFromTemplate FromTemplate = "from_template"` - `DesignMotifs []ProteinSequenceRedesignGetResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotif` Residues to redesign. Omit this field to keep the binder chain fixed. - `Filters []ProteinSequenceRedesignGetResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotifFilterUnion` Filters applied to this motif in addition to global_design_filters. - `type ProteinSequenceRedesignGetResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotifFilterExcludedAminoAcidsDesignFilterResponse struct{…}` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `type ProteinSequenceRedesignGetResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotifFilterMaxHydrophobicFractionDesignFilterResponse struct{…}` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `type ProteinSequenceRedesignGetResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotifFilterExcludedSequenceMotifsDesignFilterResponse struct{…}` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `Residues []int64` 0-indexed residues to redesign on this chain. - `Type Residues` - `const ResiduesResidues Residues = "residues"` - `NumProteins int64` Number of unique filter-passing redesigned proteins to generate. - `Structure ProteinSequenceRedesignGetResponseInputBinderProteinSequenceRedesignRunInputResponseStructure` - `URL string` URL to download the file - `URLExpiresAt Time` When the presigned URL expires - `Type Binder` - `const BinderBinder Binder = "binder"` - `GlobalDesignFilters []ProteinSequenceRedesignGetResponseInputBinderProteinSequenceRedesignRunInputResponseGlobalDesignFilterUnion` Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters. - `type ProteinSequenceRedesignGetResponseInputBinderProteinSequenceRedesignRunInputResponseGlobalDesignFilterExcludedAminoAcidsDesignFilterResponse struct{…}` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `type ProteinSequenceRedesignGetResponseInputBinderProteinSequenceRedesignRunInputResponseGlobalDesignFilterMaxHydrophobicFractionDesignFilterResponse struct{…}` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `type ProteinSequenceRedesignGetResponseInputBinderProteinSequenceRedesignRunInputResponseGlobalDesignFilterExcludedSequenceMotifsDesignFilterResponse struct{…}` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `IdempotencyKey string` - `WorkspaceID string` Workspace to run this redesign in. - `type ProteinSequenceRedesignGetResponseInputGenericProteinSequenceRedesignRunInputResponse struct{…}` - `Entities []ProteinSequenceRedesignGetResponseInputGenericProteinSequenceRedesignRunInputResponseEntity` Every chain in the input CIF, assigned exactly once. - `ChainID string` - `Type FromTemplate` - `const FromTemplateFromTemplate FromTemplate = "from_template"` - `DesignMotifs []ProteinSequenceRedesignGetResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotif` Residues to redesign. Omit this field to keep the chain fixed. - `Filters []ProteinSequenceRedesignGetResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotifFilterUnion` Filters applied to this motif in addition to global_design_filters. - `type ProteinSequenceRedesignGetResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotifFilterExcludedAminoAcidsDesignFilterResponse struct{…}` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `type ProteinSequenceRedesignGetResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotifFilterMaxHydrophobicFractionDesignFilterResponse struct{…}` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `type ProteinSequenceRedesignGetResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotifFilterExcludedSequenceMotifsDesignFilterResponse struct{…}` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `Residues []int64` 0-indexed residues to redesign on this chain. - `Type Residues` - `const ResiduesResidues Residues = "residues"` - `NumProteins int64` Number of unique filter-passing redesigned proteins to generate. - `Structure ProteinSequenceRedesignGetResponseInputGenericProteinSequenceRedesignRunInputResponseStructure` - `URL string` URL to download the file - `URLExpiresAt Time` When the presigned URL expires - `Type Generic` - `const GenericGeneric Generic = "generic"` - `GlobalDesignFilters []ProteinSequenceRedesignGetResponseInputGenericProteinSequenceRedesignRunInputResponseGlobalDesignFilterUnion` Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters. - `type ProteinSequenceRedesignGetResponseInputGenericProteinSequenceRedesignRunInputResponseGlobalDesignFilterExcludedAminoAcidsDesignFilterResponse struct{…}` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `type ProteinSequenceRedesignGetResponseInputGenericProteinSequenceRedesignRunInputResponseGlobalDesignFilterMaxHydrophobicFractionDesignFilterResponse struct{…}` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `type ProteinSequenceRedesignGetResponseInputGenericProteinSequenceRedesignRunInputResponseGlobalDesignFilterExcludedSequenceMotifsDesignFilterResponse struct{…}` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `IdempotencyKey string` - `WorkspaceID string` Workspace to run this redesign in. - `Livemode bool` Whether this resource was created with a live API key. - `Pipeline BoltzProteinRedesign` - `const BoltzProteinRedesignBoltzProteinRedesign BoltzProteinRedesign = "boltz-protein-redesign"` - `PipelineVersion V2026_07_14` - `const V2026_07_14V2026_07_14 V2026_07_14 = "v2026-07-14"` - `Progress ProteinSequenceRedesignGetResponseProgress` - `NumProteinsGenerated int64` Number of protein binders generated so far - `TotalProteinsToGenerate int64` Total number of protein binders requested - `LatestResultID string` ID of the most recently generated result - `StartedAt Time` - `Status ProteinSequenceRedesignGetResponseStatus` - `const ProteinSequenceRedesignGetResponseStatusPending ProteinSequenceRedesignGetResponseStatus = "pending"` - `const ProteinSequenceRedesignGetResponseStatusRunning ProteinSequenceRedesignGetResponseStatus = "running"` - `const ProteinSequenceRedesignGetResponseStatusSucceeded ProteinSequenceRedesignGetResponseStatus = "succeeded"` - `const ProteinSequenceRedesignGetResponseStatusFailed ProteinSequenceRedesignGetResponseStatus = "failed"` - `const ProteinSequenceRedesignGetResponseStatusStopped ProteinSequenceRedesignGetResponseStatus = "stopped"` - `StoppedAt Time` - `WorkspaceID string` Workspace ID - `IdempotencyKey string` Client-provided idempotency key ### Example ```go package main import ( "context" "fmt" "github.com/boltz-bio/boltz-api-go" "github.com/boltz-bio/boltz-api-go/option" ) func main() { client := boltzapi.NewClient( option.WithAPIKey("My API Key"), ) sequenceRedesign, err := client.Protein.SequenceRedesign.Get( context.TODO(), "id", boltzapi.ProteinSequenceRedesignGetParams{ }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", sequenceRedesign.ID) } ``` #### Response ```json { "id": "id", "completed_at": "2019-12-27T18:11:19.117Z", "created_at": "2019-12-27T18:11:19.117Z", "data_deleted_at": "2019-12-27T18:11:19.117Z", "engine": "boltz-protein-redesign", "engine_version": "v2026-07-14", "error": { "code": "code", "message": "message", "details": {} }, "input": { "entities": [ { "chain_id": "x", "role": "target", "type": "from_template" }, { "chain_id": "x", "role": "target", "type": "from_template" } ], "num_proteins": 1, "structure": { "url": "https://example.com", "url_expires_at": "2019-12-27T18:11:19.117Z" }, "type": "binder", "global_design_filters": [ { "amino_acids": [ "x" ], "type": "excluded_amino_acids" } ], "idempotency_key": "idempotency_key", "workspace_id": "workspace_id" }, "livemode": true, "pipeline": "boltz-protein-redesign", "pipeline_version": "v2026-07-14", "progress": { "num_proteins_generated": 0, "total_proteins_to_generate": 1, "latest_result_id": "latest_result_id" }, "started_at": "2019-12-27T18:11:19.117Z", "status": "pending", "stopped_at": "2019-12-27T18:11:19.117Z", "workspace_id": "workspace_id", "idempotency_key": "idempotency_key" } ``` ## Get redesigned protein sequences `client.Protein.SequenceRedesign.ListResults(ctx, id, query) (*CursorPage[ProteinSequenceRedesignListResultsResponseUnion], error)` **get** `/compute/v1/protein/sequence-redesign/{id}/results` Retrieve paginated results from a protein sequence redesign run ### Parameters - `id string` - `query ProteinSequenceRedesignListResultsParams` - `AfterID param.Field[string]` Return results after this ID - `BeforeID param.Field[string]` Return results before this ID - `IDs param.Field[string]` Comma-separated list of result IDs to filter by (max 200). Only results whose ID matches one of these is returned; missing IDs are silently skipped. Composes with `limit`, `after_id`, and `before_id` — the filter is applied before pagination. - `Limit param.Field[int64]` Max results to return. Defaults to 100. - `WorkspaceID param.Field[string]` Workspace ID. Only used with admin API keys. Ignored (or validated) for workspace-scoped keys. ### Returns - `type ProteinSequenceRedesignListResultsResponseUnion interface{…}` - `type ProteinSequenceRedesignListResultsResponseBinderProteinDesignResult struct{…}` - `ID string` Unique result ID. - `Artifacts ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultArtifacts` - `Archive ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultArtifactsArchive` - `URL string` URL to download the file - `URLExpiresAt Time` When the presigned URL expires - `Structure ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultArtifactsStructure` - `URL string` URL to download the file - `URLExpiresAt Time` When the presigned URL expires - `CreatedAt Time` - `Entities []ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultEntityUnion` Entities in the designed complex, including designed and fixed input entities. - `type ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultEntityProteinEntity struct{…}` - `ChainIDs []string` Chain IDs for this entity - `Type Protein` - `const ProteinProtein Protein = "protein"` - `Value string` Amino acid sequence (one-letter codes) - `Cyclic bool` Whether the sequence is cyclic - `Modifications []ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultEntityProteinEntityModification` CCD post-translational modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported. - `ResidueIndex int64` 0-based index of the residue to modify - `Type Ccd` Modification format. Only CCD polymer modifications are supported. - `const CcdCcd Ccd = "ccd"` - `Value string` CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for phosphoserine) - `type ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultEntityRnaEntity struct{…}` - `ChainIDs []string` Chain IDs for this entity - `Type Rna` - `const RnaRna Rna = "rna"` - `Value string` RNA nucleotide sequence (A, C, G, U, N) - `Cyclic bool` Whether the sequence is cyclic - `Modifications []ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultEntityRnaEntityModification` CCD chemical modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported. - `ResidueIndex int64` 0-based index of the residue to modify - `Type Ccd` Modification format. Only CCD polymer modifications are supported. - `const CcdCcd Ccd = "ccd"` - `Value string` CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for phosphoserine) - `type ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultEntityDnaEntity struct{…}` - `ChainIDs []string` Chain IDs for this entity - `Type Dna` - `const DnaDna Dna = "dna"` - `Value string` DNA nucleotide sequence (A, C, G, T, N) - `Cyclic bool` Whether the sequence is cyclic - `Modifications []ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultEntityDnaEntityModification` CCD chemical modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported. - `ResidueIndex int64` 0-based index of the residue to modify - `Type Ccd` Modification format. Only CCD polymer modifications are supported. - `const CcdCcd Ccd = "ccd"` - `Value string` CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for phosphoserine) - `type ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultEntityLigandCcdEntity struct{…}` - `ChainIDs []string` Chain IDs for this ligand - `Type LigandCcd` - `const LigandCcdLigandCcd LigandCcd = "ligand_ccd"` - `Value string` CCD code (e.g., ATP, ADP) - `type ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultEntityLigandSmilesEntity struct{…}` - `ChainIDs []string` Chain IDs for this ligand - `Type LigandSmiles` - `const LigandSmilesLigandSmiles LigandSmiles = "ligand_smiles"` - `Value string` SMILES string representing the ligand - `Metrics ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultMetrics` Structural and binding quality metrics for a designed protein binder - `BindingConfidence float64` Confidence that the designed binder binds the target (0-1). Primary metric for hit discovery. - `HelixFraction float64` Fraction of the designed sequence forming alpha helices (0-1). - `Iptm float64` Interface predicted TM score (0-1). Confidence in the protein-protein interface. - `LoopFraction float64` Fraction of the designed sequence in coil/loop regions (0-1). - `MinInteractionPae float64` Minimum predicted aligned error at the interface (Angstroms). Lower values indicate higher confidence. - `SheetFraction float64` Fraction of the designed sequence forming beta sheets (0-1). - `StructureConfidence float64` Confidence in the predicted 3D structure (0-1). - `Type Binder` - `const BinderBinder Binder = "binder"` - `Warnings []ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultWarning` 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 - `type ProteinSequenceRedesignListResultsResponseGenericProteinDesignResult struct{…}` - `ID string` Unique result ID. - `Artifacts ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultArtifacts` - `Archive ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultArtifactsArchive` - `URL string` URL to download the file - `URLExpiresAt Time` When the presigned URL expires - `Structure ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultArtifactsStructure` - `URL string` URL to download the file - `URLExpiresAt Time` When the presigned URL expires - `CreatedAt Time` - `Entities []ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultEntityUnion` Entities in the designed complex, including designed and fixed input entities. - `type ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultEntityProteinEntity struct{…}` - `ChainIDs []string` Chain IDs for this entity - `Type Protein` - `const ProteinProtein Protein = "protein"` - `Value string` Amino acid sequence (one-letter codes) - `Cyclic bool` Whether the sequence is cyclic - `Modifications []ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultEntityProteinEntityModification` CCD post-translational modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported. - `ResidueIndex int64` 0-based index of the residue to modify - `Type Ccd` Modification format. Only CCD polymer modifications are supported. - `const CcdCcd Ccd = "ccd"` - `Value string` CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for phosphoserine) - `type ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultEntityRnaEntity struct{…}` - `ChainIDs []string` Chain IDs for this entity - `Type Rna` - `const RnaRna Rna = "rna"` - `Value string` RNA nucleotide sequence (A, C, G, U, N) - `Cyclic bool` Whether the sequence is cyclic - `Modifications []ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultEntityRnaEntityModification` CCD chemical modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported. - `ResidueIndex int64` 0-based index of the residue to modify - `Type Ccd` Modification format. Only CCD polymer modifications are supported. - `const CcdCcd Ccd = "ccd"` - `Value string` CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for phosphoserine) - `type ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultEntityDnaEntity struct{…}` - `ChainIDs []string` Chain IDs for this entity - `Type Dna` - `const DnaDna Dna = "dna"` - `Value string` DNA nucleotide sequence (A, C, G, T, N) - `Cyclic bool` Whether the sequence is cyclic - `Modifications []ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultEntityDnaEntityModification` CCD chemical modifications. Optional; defaults to an empty list when omitted. SMILES modifications are not supported. - `ResidueIndex int64` 0-based index of the residue to modify - `Type Ccd` Modification format. Only CCD polymer modifications are supported. - `const CcdCcd Ccd = "ccd"` - `Value string` CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for phosphoserine) - `type ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultEntityLigandCcdEntity struct{…}` - `ChainIDs []string` Chain IDs for this ligand - `Type LigandCcd` - `const LigandCcdLigandCcd LigandCcd = "ligand_ccd"` - `Value string` CCD code (e.g., ATP, ADP) - `type ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultEntityLigandSmilesEntity struct{…}` - `ChainIDs []string` Chain IDs for this ligand - `Type LigandSmiles` - `const LigandSmilesLigandSmiles LigandSmiles = "ligand_smiles"` - `Value string` SMILES string representing the ligand - `Metrics ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultMetrics` Structure and design-quality metrics for a generic protein design. - `HelixFraction float64` Fraction of the designed sequence forming alpha helices (0-1). - `LoopFraction float64` Fraction of the designed sequence in coil/loop regions (0-1). - `SheetFraction float64` Fraction of the designed sequence forming beta sheets (0-1). - `StructureConfidence float64` Confidence in the predicted 3D structure (0-1). - `Type Generic` - `const GenericGeneric Generic = "generic"` - `Warnings []ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultWarning` 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 ### Example ```go package main import ( "context" "fmt" "github.com/boltz-bio/boltz-api-go" "github.com/boltz-bio/boltz-api-go/option" ) func main() { client := boltzapi.NewClient( option.WithAPIKey("My API Key"), ) page, err := client.Protein.SequenceRedesign.ListResults( context.TODO(), "id", boltzapi.ProteinSequenceRedesignListResultsParams{ }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` #### Response ```json { "data": [ { "id": "id", "artifacts": { "archive": { "url": "https://example.com", "url_expires_at": "2019-12-27T18:11:19.117Z" }, "structure": { "url": "https://example.com", "url_expires_at": "2019-12-27T18:11:19.117Z" } }, "created_at": "2019-12-27T18:11:19.117Z", "entities": [ { "chain_ids": [ "string" ], "type": "protein", "value": "value", "cyclic": true, "modifications": [ { "residue_index": 0, "type": "ccd", "value": "value" } ] } ], "metrics": { "binding_confidence": 0, "helix_fraction": 0, "iptm": 0, "loop_fraction": 0, "min_interaction_pae": 0, "sheet_fraction": 0, "structure_confidence": 0 }, "type": "binder", "warnings": [ { "code": "code", "message": "message" } ] } ], "first_id": "first_id", "has_more": true, "last_id": "last_id" } ``` ## Stop a running protein sequence redesign run `client.Protein.SequenceRedesign.Stop(ctx, id) (*ProteinSequenceRedesignStopResponse, error)` **post** `/compute/v1/protein/sequence-redesign/{id}/stop` Stop an in-progress protein sequence redesign run early ### Parameters - `id string` ### Returns - `type ProteinSequenceRedesignStopResponse struct{…}` A fixed-structure protein sequence redesign run. - `ID string` Unique ProteinSequenceRedesignRun identifier - `CompletedAt Time` - `CreatedAt Time` - `DataDeletedAt Time` When the input, output, and result data was permanently deleted. Null if data has not been deleted. - `Engine BoltzProteinRedesign` Deprecated. Use pipeline instead. - `const BoltzProteinRedesignBoltzProteinRedesign BoltzProteinRedesign = "boltz-protein-redesign"` - `EngineVersion V2026_07_14` Deprecated. Use pipeline_version instead. - `const V2026_07_14V2026_07_14 V2026_07_14 = "v2026-07-14"` - `Error ProteinSequenceRedesignStopResponseError` - `Code string` Machine-readable error code - `Message string` Human-readable error message - `Details any` Additional field-level error details keyed by input path, when available. - `Input ProteinSequenceRedesignStopResponseInputUnion` Pipeline input (null if data deleted) - `type ProteinSequenceRedesignStopResponseInputBinderProteinSequenceRedesignRunInputResponse struct{…}` - `Entities []ProteinSequenceRedesignStopResponseInputBinderProteinSequenceRedesignRunInputResponseEntityUnion` Every chain in the input CIF, assigned exactly once as target or binder. - `type ProteinSequenceRedesignStopResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignTargetEntityResponse struct{…}` A fixed target chain from the input CIF. - `ChainID string` - `Role Target` - `const TargetTarget Target = "target"` - `Type FromTemplate` - `const FromTemplateFromTemplate FromTemplate = "from_template"` - `type ProteinSequenceRedesignStopResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponse struct{…}` - `ChainID string` - `Role Binder` - `const BinderBinder Binder = "binder"` - `Type FromTemplate` - `const FromTemplateFromTemplate FromTemplate = "from_template"` - `DesignMotifs []ProteinSequenceRedesignStopResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotif` Residues to redesign. Omit this field to keep the binder chain fixed. - `Filters []ProteinSequenceRedesignStopResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotifFilterUnion` Filters applied to this motif in addition to global_design_filters. - `type ProteinSequenceRedesignStopResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotifFilterExcludedAminoAcidsDesignFilterResponse struct{…}` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `type ProteinSequenceRedesignStopResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotifFilterMaxHydrophobicFractionDesignFilterResponse struct{…}` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `type ProteinSequenceRedesignStopResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotifFilterExcludedSequenceMotifsDesignFilterResponse struct{…}` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `Residues []int64` 0-indexed residues to redesign on this chain. - `Type Residues` - `const ResiduesResidues Residues = "residues"` - `NumProteins int64` Number of unique filter-passing redesigned proteins to generate. - `Structure ProteinSequenceRedesignStopResponseInputBinderProteinSequenceRedesignRunInputResponseStructure` - `URL string` URL to download the file - `URLExpiresAt Time` When the presigned URL expires - `Type Binder` - `const BinderBinder Binder = "binder"` - `GlobalDesignFilters []ProteinSequenceRedesignStopResponseInputBinderProteinSequenceRedesignRunInputResponseGlobalDesignFilterUnion` Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters. - `type ProteinSequenceRedesignStopResponseInputBinderProteinSequenceRedesignRunInputResponseGlobalDesignFilterExcludedAminoAcidsDesignFilterResponse struct{…}` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `type ProteinSequenceRedesignStopResponseInputBinderProteinSequenceRedesignRunInputResponseGlobalDesignFilterMaxHydrophobicFractionDesignFilterResponse struct{…}` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `type ProteinSequenceRedesignStopResponseInputBinderProteinSequenceRedesignRunInputResponseGlobalDesignFilterExcludedSequenceMotifsDesignFilterResponse struct{…}` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `IdempotencyKey string` - `WorkspaceID string` Workspace to run this redesign in. - `type ProteinSequenceRedesignStopResponseInputGenericProteinSequenceRedesignRunInputResponse struct{…}` - `Entities []ProteinSequenceRedesignStopResponseInputGenericProteinSequenceRedesignRunInputResponseEntity` Every chain in the input CIF, assigned exactly once. - `ChainID string` - `Type FromTemplate` - `const FromTemplateFromTemplate FromTemplate = "from_template"` - `DesignMotifs []ProteinSequenceRedesignStopResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotif` Residues to redesign. Omit this field to keep the chain fixed. - `Filters []ProteinSequenceRedesignStopResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotifFilterUnion` Filters applied to this motif in addition to global_design_filters. - `type ProteinSequenceRedesignStopResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotifFilterExcludedAminoAcidsDesignFilterResponse struct{…}` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `type ProteinSequenceRedesignStopResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotifFilterMaxHydrophobicFractionDesignFilterResponse struct{…}` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `type ProteinSequenceRedesignStopResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotifFilterExcludedSequenceMotifsDesignFilterResponse struct{…}` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `Residues []int64` 0-indexed residues to redesign on this chain. - `Type Residues` - `const ResiduesResidues Residues = "residues"` - `NumProteins int64` Number of unique filter-passing redesigned proteins to generate. - `Structure ProteinSequenceRedesignStopResponseInputGenericProteinSequenceRedesignRunInputResponseStructure` - `URL string` URL to download the file - `URLExpiresAt Time` When the presigned URL expires - `Type Generic` - `const GenericGeneric Generic = "generic"` - `GlobalDesignFilters []ProteinSequenceRedesignStopResponseInputGenericProteinSequenceRedesignRunInputResponseGlobalDesignFilterUnion` Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters. - `type ProteinSequenceRedesignStopResponseInputGenericProteinSequenceRedesignRunInputResponseGlobalDesignFilterExcludedAminoAcidsDesignFilterResponse struct{…}` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `type ProteinSequenceRedesignStopResponseInputGenericProteinSequenceRedesignRunInputResponseGlobalDesignFilterMaxHydrophobicFractionDesignFilterResponse struct{…}` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `type ProteinSequenceRedesignStopResponseInputGenericProteinSequenceRedesignRunInputResponseGlobalDesignFilterExcludedSequenceMotifsDesignFilterResponse struct{…}` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `IdempotencyKey string` - `WorkspaceID string` Workspace to run this redesign in. - `Livemode bool` Whether this resource was created with a live API key. - `Pipeline BoltzProteinRedesign` - `const BoltzProteinRedesignBoltzProteinRedesign BoltzProteinRedesign = "boltz-protein-redesign"` - `PipelineVersion V2026_07_14` - `const V2026_07_14V2026_07_14 V2026_07_14 = "v2026-07-14"` - `Progress ProteinSequenceRedesignStopResponseProgress` - `NumProteinsGenerated int64` Number of protein binders generated so far - `TotalProteinsToGenerate int64` Total number of protein binders requested - `LatestResultID string` ID of the most recently generated result - `StartedAt Time` - `Status ProteinSequenceRedesignStopResponseStatus` - `const ProteinSequenceRedesignStopResponseStatusPending ProteinSequenceRedesignStopResponseStatus = "pending"` - `const ProteinSequenceRedesignStopResponseStatusRunning ProteinSequenceRedesignStopResponseStatus = "running"` - `const ProteinSequenceRedesignStopResponseStatusSucceeded ProteinSequenceRedesignStopResponseStatus = "succeeded"` - `const ProteinSequenceRedesignStopResponseStatusFailed ProteinSequenceRedesignStopResponseStatus = "failed"` - `const ProteinSequenceRedesignStopResponseStatusStopped ProteinSequenceRedesignStopResponseStatus = "stopped"` - `StoppedAt Time` - `WorkspaceID string` Workspace ID - `IdempotencyKey string` Client-provided idempotency key ### Example ```go package main import ( "context" "fmt" "github.com/boltz-bio/boltz-api-go" "github.com/boltz-bio/boltz-api-go/option" ) func main() { client := boltzapi.NewClient( option.WithAPIKey("My API Key"), ) response, err := client.Protein.SequenceRedesign.Stop(context.TODO(), "id") if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.ID) } ``` #### Response ```json { "id": "id", "completed_at": "2019-12-27T18:11:19.117Z", "created_at": "2019-12-27T18:11:19.117Z", "data_deleted_at": "2019-12-27T18:11:19.117Z", "engine": "boltz-protein-redesign", "engine_version": "v2026-07-14", "error": { "code": "code", "message": "message", "details": {} }, "input": { "entities": [ { "chain_id": "x", "role": "target", "type": "from_template" }, { "chain_id": "x", "role": "target", "type": "from_template" } ], "num_proteins": 1, "structure": { "url": "https://example.com", "url_expires_at": "2019-12-27T18:11:19.117Z" }, "type": "binder", "global_design_filters": [ { "amino_acids": [ "x" ], "type": "excluded_amino_acids" } ], "idempotency_key": "idempotency_key", "workspace_id": "workspace_id" }, "livemode": true, "pipeline": "boltz-protein-redesign", "pipeline_version": "v2026-07-14", "progress": { "num_proteins_generated": 0, "total_proteins_to_generate": 1, "latest_result_id": "latest_result_id" }, "started_at": "2019-12-27T18:11:19.117Z", "status": "pending", "stopped_at": "2019-12-27T18:11:19.117Z", "workspace_id": "workspace_id", "idempotency_key": "idempotency_key" } ``` ## Resume a stopped protein sequence redesign run `client.Protein.SequenceRedesign.Resume(ctx, id) (*ProteinSequenceRedesignResumeResponse, error)` **post** `/compute/v1/protein/sequence-redesign/{id}/resume` Resume a stopped protein sequence redesign run from its last checkpoint ### Parameters - `id string` ### Returns - `type ProteinSequenceRedesignResumeResponse struct{…}` A fixed-structure protein sequence redesign run. - `ID string` Unique ProteinSequenceRedesignRun identifier - `CompletedAt Time` - `CreatedAt Time` - `DataDeletedAt Time` When the input, output, and result data was permanently deleted. Null if data has not been deleted. - `Engine BoltzProteinRedesign` Deprecated. Use pipeline instead. - `const BoltzProteinRedesignBoltzProteinRedesign BoltzProteinRedesign = "boltz-protein-redesign"` - `EngineVersion V2026_07_14` Deprecated. Use pipeline_version instead. - `const V2026_07_14V2026_07_14 V2026_07_14 = "v2026-07-14"` - `Error ProteinSequenceRedesignResumeResponseError` - `Code string` Machine-readable error code - `Message string` Human-readable error message - `Details any` Additional field-level error details keyed by input path, when available. - `Input ProteinSequenceRedesignResumeResponseInputUnion` Pipeline input (null if data deleted) - `type ProteinSequenceRedesignResumeResponseInputBinderProteinSequenceRedesignRunInputResponse struct{…}` - `Entities []ProteinSequenceRedesignResumeResponseInputBinderProteinSequenceRedesignRunInputResponseEntityUnion` Every chain in the input CIF, assigned exactly once as target or binder. - `type ProteinSequenceRedesignResumeResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignTargetEntityResponse struct{…}` A fixed target chain from the input CIF. - `ChainID string` - `Role Target` - `const TargetTarget Target = "target"` - `Type FromTemplate` - `const FromTemplateFromTemplate FromTemplate = "from_template"` - `type ProteinSequenceRedesignResumeResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponse struct{…}` - `ChainID string` - `Role Binder` - `const BinderBinder Binder = "binder"` - `Type FromTemplate` - `const FromTemplateFromTemplate FromTemplate = "from_template"` - `DesignMotifs []ProteinSequenceRedesignResumeResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotif` Residues to redesign. Omit this field to keep the binder chain fixed. - `Filters []ProteinSequenceRedesignResumeResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotifFilterUnion` Filters applied to this motif in addition to global_design_filters. - `type ProteinSequenceRedesignResumeResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotifFilterExcludedAminoAcidsDesignFilterResponse struct{…}` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `type ProteinSequenceRedesignResumeResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotifFilterMaxHydrophobicFractionDesignFilterResponse struct{…}` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `type ProteinSequenceRedesignResumeResponseInputBinderProteinSequenceRedesignRunInputResponseEntityBinderSequenceRedesignBinderEntityResponseDesignMotifFilterExcludedSequenceMotifsDesignFilterResponse struct{…}` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `Residues []int64` 0-indexed residues to redesign on this chain. - `Type Residues` - `const ResiduesResidues Residues = "residues"` - `NumProteins int64` Number of unique filter-passing redesigned proteins to generate. - `Structure ProteinSequenceRedesignResumeResponseInputBinderProteinSequenceRedesignRunInputResponseStructure` - `URL string` URL to download the file - `URLExpiresAt Time` When the presigned URL expires - `Type Binder` - `const BinderBinder Binder = "binder"` - `GlobalDesignFilters []ProteinSequenceRedesignResumeResponseInputBinderProteinSequenceRedesignRunInputResponseGlobalDesignFilterUnion` Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters. - `type ProteinSequenceRedesignResumeResponseInputBinderProteinSequenceRedesignRunInputResponseGlobalDesignFilterExcludedAminoAcidsDesignFilterResponse struct{…}` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `type ProteinSequenceRedesignResumeResponseInputBinderProteinSequenceRedesignRunInputResponseGlobalDesignFilterMaxHydrophobicFractionDesignFilterResponse struct{…}` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `type ProteinSequenceRedesignResumeResponseInputBinderProteinSequenceRedesignRunInputResponseGlobalDesignFilterExcludedSequenceMotifsDesignFilterResponse struct{…}` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `IdempotencyKey string` - `WorkspaceID string` Workspace to run this redesign in. - `type ProteinSequenceRedesignResumeResponseInputGenericProteinSequenceRedesignRunInputResponse struct{…}` - `Entities []ProteinSequenceRedesignResumeResponseInputGenericProteinSequenceRedesignRunInputResponseEntity` Every chain in the input CIF, assigned exactly once. - `ChainID string` - `Type FromTemplate` - `const FromTemplateFromTemplate FromTemplate = "from_template"` - `DesignMotifs []ProteinSequenceRedesignResumeResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotif` Residues to redesign. Omit this field to keep the chain fixed. - `Filters []ProteinSequenceRedesignResumeResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotifFilterUnion` Filters applied to this motif in addition to global_design_filters. - `type ProteinSequenceRedesignResumeResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotifFilterExcludedAminoAcidsDesignFilterResponse struct{…}` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `type ProteinSequenceRedesignResumeResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotifFilterMaxHydrophobicFractionDesignFilterResponse struct{…}` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `type ProteinSequenceRedesignResumeResponseInputGenericProteinSequenceRedesignRunInputResponseEntityDesignMotifFilterExcludedSequenceMotifsDesignFilterResponse struct{…}` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `Residues []int64` 0-indexed residues to redesign on this chain. - `Type Residues` - `const ResiduesResidues Residues = "residues"` - `NumProteins int64` Number of unique filter-passing redesigned proteins to generate. - `Structure ProteinSequenceRedesignResumeResponseInputGenericProteinSequenceRedesignRunInputResponseStructure` - `URL string` URL to download the file - `URLExpiresAt Time` When the presigned URL expires - `Type Generic` - `const GenericGeneric Generic = "generic"` - `GlobalDesignFilters []ProteinSequenceRedesignResumeResponseInputGenericProteinSequenceRedesignRunInputResponseGlobalDesignFilterUnion` Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters. - `type ProteinSequenceRedesignResumeResponseInputGenericProteinSequenceRedesignRunInputResponseGlobalDesignFilterExcludedAminoAcidsDesignFilterResponse struct{…}` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `type ProteinSequenceRedesignResumeResponseInputGenericProteinSequenceRedesignRunInputResponseGlobalDesignFilterMaxHydrophobicFractionDesignFilterResponse struct{…}` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `type ProteinSequenceRedesignResumeResponseInputGenericProteinSequenceRedesignRunInputResponseGlobalDesignFilterExcludedSequenceMotifsDesignFilterResponse struct{…}` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `IdempotencyKey string` - `WorkspaceID string` Workspace to run this redesign in. - `Livemode bool` Whether this resource was created with a live API key. - `Pipeline BoltzProteinRedesign` - `const BoltzProteinRedesignBoltzProteinRedesign BoltzProteinRedesign = "boltz-protein-redesign"` - `PipelineVersion V2026_07_14` - `const V2026_07_14V2026_07_14 V2026_07_14 = "v2026-07-14"` - `Progress ProteinSequenceRedesignResumeResponseProgress` - `NumProteinsGenerated int64` Number of protein binders generated so far - `TotalProteinsToGenerate int64` Total number of protein binders requested - `LatestResultID string` ID of the most recently generated result - `StartedAt Time` - `Status ProteinSequenceRedesignResumeResponseStatus` - `const ProteinSequenceRedesignResumeResponseStatusPending ProteinSequenceRedesignResumeResponseStatus = "pending"` - `const ProteinSequenceRedesignResumeResponseStatusRunning ProteinSequenceRedesignResumeResponseStatus = "running"` - `const ProteinSequenceRedesignResumeResponseStatusSucceeded ProteinSequenceRedesignResumeResponseStatus = "succeeded"` - `const ProteinSequenceRedesignResumeResponseStatusFailed ProteinSequenceRedesignResumeResponseStatus = "failed"` - `const ProteinSequenceRedesignResumeResponseStatusStopped ProteinSequenceRedesignResumeResponseStatus = "stopped"` - `StoppedAt Time` - `WorkspaceID string` Workspace ID - `IdempotencyKey string` Client-provided idempotency key ### Example ```go package main import ( "context" "fmt" "github.com/boltz-bio/boltz-api-go" "github.com/boltz-bio/boltz-api-go/option" ) func main() { client := boltzapi.NewClient( option.WithAPIKey("My API Key"), ) response, err := client.Protein.SequenceRedesign.Resume(context.TODO(), "id") if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.ID) } ``` #### Response ```json { "id": "id", "completed_at": "2019-12-27T18:11:19.117Z", "created_at": "2019-12-27T18:11:19.117Z", "data_deleted_at": "2019-12-27T18:11:19.117Z", "engine": "boltz-protein-redesign", "engine_version": "v2026-07-14", "error": { "code": "code", "message": "message", "details": {} }, "input": { "entities": [ { "chain_id": "x", "role": "target", "type": "from_template" }, { "chain_id": "x", "role": "target", "type": "from_template" } ], "num_proteins": 1, "structure": { "url": "https://example.com", "url_expires_at": "2019-12-27T18:11:19.117Z" }, "type": "binder", "global_design_filters": [ { "amino_acids": [ "x" ], "type": "excluded_amino_acids" } ], "idempotency_key": "idempotency_key", "workspace_id": "workspace_id" }, "livemode": true, "pipeline": "boltz-protein-redesign", "pipeline_version": "v2026-07-14", "progress": { "num_proteins_generated": 0, "total_proteins_to_generate": 1, "latest_result_id": "latest_result_id" }, "started_at": "2019-12-27T18:11:19.117Z", "status": "pending", "stopped_at": "2019-12-27T18:11:19.117Z", "workspace_id": "workspace_id", "idempotency_key": "idempotency_key" } ``` ## Delete protein sequence redesign run data `client.Protein.SequenceRedesign.DeleteData(ctx, id) (*ProteinSequenceRedesignDeleteDataResponse, error)` **post** `/compute/v1/protein/sequence-redesign/{id}/delete-data` Permanently delete the input, output, and result data associated with this sequence redesign run. The sequence redesign run record itself is retained with a `data_deleted_at` timestamp. This action is irreversible. ### Parameters - `id string` ### Returns - `type ProteinSequenceRedesignDeleteDataResponse struct{…}` - `ID string` ID of the resource whose data was deleted - `DataDeleted bool` - `const ProteinSequenceRedesignDeleteDataResponseDataDeletedTrue ProteinSequenceRedesignDeleteDataResponseDataDeleted = true` - `DataDeletedAt Time` When the data was deleted ### Example ```go package main import ( "context" "fmt" "github.com/boltz-bio/boltz-api-go" "github.com/boltz-bio/boltz-api-go/option" ) func main() { client := boltzapi.NewClient( option.WithAPIKey("My API Key"), ) response, err := client.Protein.SequenceRedesign.DeleteData(context.TODO(), "id") if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.ID) } ``` #### Response ```json { "id": "id", "data_deleted": true, "data_deleted_at": "2019-12-27T18:11:19.117Z" } ``` ## Estimate cost for a protein sequence redesign run `client.Protein.SequenceRedesign.EstimateCost(ctx, body) (*ProteinSequenceRedesignEstimateCostResponse, error)` **post** `/compute/v1/protein/sequence-redesign/estimate-cost` Estimate the cost of a protein sequence redesign run without creating any resource or consuming GPU. ### Parameters - `body ProteinSequenceRedesignEstimateCostParams` - `Entities param.Field[[]ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputEntityUnion]` Every chain in the input CIF, assigned exactly once as target or binder. - `ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignTargetEntity` - `ChainID string` - `Role Target` - `const TargetTarget Target = "target"` - `Type FromTemplate` - `const FromTemplateFromTemplate FromTemplate = "from_template"` - `ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignBinderEntity` - `ChainID string` - `Role Binder` - `const BinderBinder Binder = "binder"` - `Type FromTemplate` - `const FromTemplateFromTemplate FromTemplate = "from_template"` - `DesignMotifs []ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignBinderEntityDesignMotif` Residues to redesign. Omit this field to keep the binder chain fixed. - `Filters []ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignBinderEntityDesignMotifFilterUnion` Filters applied to this motif in addition to global_design_filters. - `ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignBinderEntityDesignMotifFilterExcludedAminoAcidsDesignFilter` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignBinderEntityDesignMotifFilterMaxHydrophobicFractionDesignFilter` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignBinderEntityDesignMotifFilterExcludedSequenceMotifsDesignFilter` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `Residues []int64` 0-indexed residues to redesign on this chain. - `Type Residues` - `const ResiduesResidues Residues = "residues"` - `NumProteins param.Field[int64]` Number of unique filter-passing redesigned proteins to generate. - `Structure param.Field[ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputStructureUnion]` How to provide a CIF structure file. URLs are auto-detected; base64 uploads must use chemical/x-cif media type. - `ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputStructureURLSource` - `Type URL` - `const URLURL URL = "url"` - `URL string` - `ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputStructureCifBase64Source` - `Data string` Base64-encoded CIF file contents - `MediaType ChemicalXCif` Must be chemical/x-cif for CIF files - `const ChemicalXCifChemicalXCif ChemicalXCif = "chemical/x-cif"` - `Type Base64` - `const Base64Base64 Base64 = "base64"` - `Type param.Field[Binder]` - `const BinderBinder Binder = "binder"` - `GlobalDesignFilters param.Field[[]ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputGlobalDesignFilterUnion]` Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters. - `ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputGlobalDesignFilterExcludedAminoAcidsDesignFilter` - `AminoAcids []string` Single-letter amino-acid codes that must not occur in the filtered designed region. - `Type ExcludedAminoAcids` - `const ExcludedAminoAcidsExcludedAminoAcids ExcludedAminoAcids = "excluded_amino_acids"` - `ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputGlobalDesignFilterMaxHydrophobicFractionDesignFilter` - `MaxFraction float64` - `Type MaxHydrophobicFraction` - `const MaxHydrophobicFractionMaxHydrophobicFraction MaxHydrophobicFraction = "max_hydrophobic_fraction"` - `ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputGlobalDesignFilterExcludedSequenceMotifsDesignFilter` - `Motifs []string` Sequence motifs that must not occur. X matches any single residue. - `Type ExcludedSequenceMotifs` - `const ExcludedSequenceMotifsExcludedSequenceMotifs ExcludedSequenceMotifs = "excluded_sequence_motifs"` - `IdempotencyKey param.Field[string]` - `WorkspaceID param.Field[string]` Workspace to run this redesign in. ### Returns - `type ProteinSequenceRedesignEstimateCostResponse struct{…}` Estimate response with monetary values encoded as decimal strings to preserve precision. - `Breakdown ProteinSequenceRedesignEstimateCostResponseBreakdown` Cost breakdown for the billed application. - `Application ProteinSequenceRedesignEstimateCostResponseBreakdownApplication` - `const ProteinSequenceRedesignEstimateCostResponseBreakdownApplicationStructureAndBinding ProteinSequenceRedesignEstimateCostResponseBreakdownApplication = "structure_and_binding"` - `const ProteinSequenceRedesignEstimateCostResponseBreakdownApplicationSmallMoleculeDesign ProteinSequenceRedesignEstimateCostResponseBreakdownApplication = "small_molecule_design"` - `const ProteinSequenceRedesignEstimateCostResponseBreakdownApplicationSmallMoleculeLibraryScreen ProteinSequenceRedesignEstimateCostResponseBreakdownApplication = "small_molecule_library_screen"` - `const ProteinSequenceRedesignEstimateCostResponseBreakdownApplicationProteinDesign ProteinSequenceRedesignEstimateCostResponseBreakdownApplication = "protein_design"` - `const ProteinSequenceRedesignEstimateCostResponseBreakdownApplicationProteinRedesign ProteinSequenceRedesignEstimateCostResponseBreakdownApplication = "protein_redesign"` - `const ProteinSequenceRedesignEstimateCostResponseBreakdownApplicationProteinLibraryScreen ProteinSequenceRedesignEstimateCostResponseBreakdownApplication = "protein_library_screen"` - `const ProteinSequenceRedesignEstimateCostResponseBreakdownApplicationAdme ProteinSequenceRedesignEstimateCostResponseBreakdownApplication = "adme"` - `CostPerUnitUsd 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. - `NumUnits int64` 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` - `EstimatedCostUsd string` Estimated total cost as a decimal string ### Example ```go package main import ( "context" "fmt" "github.com/boltz-bio/boltz-api-go" "github.com/boltz-bio/boltz-api-go/option" ) func main() { client := boltzapi.NewClient( option.WithAPIKey("My API Key"), ) response, err := client.Protein.SequenceRedesign.EstimateCost(context.TODO(), boltzapi.ProteinSequenceRedesignEstimateCostParams{ OfBinderProteinSequenceRedesignRunInput: &boltzapi.ProteinSequenceRedesignEstimateCostParamsBodyBinderProteinSequenceRedesignRunInput{ Entities: []boltzapi.ProteinSequenceRedesignEstimateCostParamsBodyBinderProteinSequenceRedesignRunInputEntityUnion{boltzapi.ProteinSequenceRedesignEstimateCostParamsBodyBinderProteinSequenceRedesignRunInputEntityUnion{ OfProteinSequenceRedesignEstimateCostsBodyBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignTargetEntity: &boltzapi.ProteinSequenceRedesignEstimateCostParamsBodyBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignTargetEntity{ ChainID: "x", }, }, boltzapi.ProteinSequenceRedesignEstimateCostParamsBodyBinderProteinSequenceRedesignRunInputEntityUnion{ OfProteinSequenceRedesignEstimateCostsBodyBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignTargetEntity: &boltzapi.ProteinSequenceRedesignEstimateCostParamsBodyBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignTargetEntity{ ChainID: "x", }, }}, NumProteins: 1, Structure: boltzapi.ProteinSequenceRedesignEstimateCostParamsBodyBinderProteinSequenceRedesignRunInputStructureUnion{ OfProteinSequenceRedesignEstimateCostsBodyBinderProteinSequenceRedesignRunInputStructureURLSource: &boltzapi.ProteinSequenceRedesignEstimateCostParamsBodyBinderProteinSequenceRedesignRunInputStructureURLSource{ URL: "https://example.com", }, }, }, }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Breakdown) } ``` #### Response ```json { "breakdown": { "application": "structure_and_binding", "cost_per_unit_usd": "0.0500", "num_units": 1 }, "disclaimer": "This is an estimate only and may differ from your actual charges. Final billing is based on exact token counts computed at run time. For large library screens, the estimate is extrapolated from a sample and may be less accurate for highly variable inputs.", "estimated_cost_usd": "0.0500" } ```