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

ParametersExpand Collapse

id string

query ProteinSequenceRedesignListResultsParams

AfterID param.Field[string]Optional

Return results after this ID

BeforeID param.Field[string]Optional

Return results before this ID

IDs param.Field[string]Optional

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.

maxLength8000

Limit param.Field[int64]Optional

Max results to return. Defaults to 100.

minimum1

maximum1000

WorkspaceID param.Field[string]Optional

Workspace ID. Only used with admin API keys. Ignored (or validated) for workspace-scoped keys.

ReturnsExpand Collapse

type ProteinSequenceRedesignListResultsResponseUnion interface{…}

One of the following:

type ProteinSequenceRedesignListResultsResponseBinderProteinDesignResult struct{…}

ID string

Unique result ID.

Artifacts ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultArtifacts

Archive ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultArtifactsArchive

URL string

URL to download the file

formaturi

URLExpiresAt Time

When the presigned URL expires

formatdate-time

Structure ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultArtifactsStructureOptional

URL string

URL to download the file

formaturi

URLExpiresAt Time

When the presigned URL expires

formatdate-time

CreatedAt Time

formatdate-time

Entities []ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultEntityUnion

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

One of the following:

type ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultEntityProteinEntity struct{…}

ChainIDs []string

Chain IDs for this entity

Type Protein

Value string

Amino acid sequence (one-letter codes)

Cyclic boolOptional

Whether the sequence is cyclic

Modifications []ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultEntityProteinEntityModificationOptional

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

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)

type ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultEntityRnaEntity struct{…}

ChainIDs []string

Chain IDs for this entity

Type Rna

Value string

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

Cyclic boolOptional

Whether the sequence is cyclic

Modifications []ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultEntityRnaEntityModificationOptional

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

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)

type ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultEntityDnaEntity struct{…}

ChainIDs []string

Chain IDs for this entity

Type Dna

Value string

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

Cyclic boolOptional

Whether the sequence is cyclic

Modifications []ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultEntityDnaEntityModificationOptional

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

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)

type ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultEntityLigandCcdEntity struct{…}

ChainIDs []string

Chain IDs for this ligand

Type LigandCcd

Value string

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

type ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultEntityLigandSmilesEntity struct{…}

ChainIDs []string

Chain IDs for this ligand

Type LigandSmiles

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).

minimum0

maximum1

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).

minimum0

maximum1

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).

minimum0

maximum1

StructureConfidence float64

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

Type Binder

Warnings []ProteinSequenceRedesignListResultsResponseBinderProteinDesignResultWarningOptional

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

formaturi

URLExpiresAt Time

When the presigned URL expires

formatdate-time

Structure ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultArtifactsStructureOptional

URL string

URL to download the file

formaturi

URLExpiresAt Time

When the presigned URL expires

formatdate-time

CreatedAt Time

formatdate-time

Entities []ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultEntityUnion

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

One of the following:

type ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultEntityProteinEntity struct{…}

ChainIDs []string

Chain IDs for this entity

Type Protein

Value string

Amino acid sequence (one-letter codes)

Cyclic boolOptional

Whether the sequence is cyclic

Modifications []ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultEntityProteinEntityModificationOptional

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

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)

type ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultEntityRnaEntity struct{…}

ChainIDs []string

Chain IDs for this entity

Type Rna

Value string

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

Cyclic boolOptional

Whether the sequence is cyclic

Modifications []ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultEntityRnaEntityModificationOptional

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

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)

type ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultEntityDnaEntity struct{…}

ChainIDs []string

Chain IDs for this entity

Type Dna

Value string

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

Cyclic boolOptional

Whether the sequence is cyclic

Modifications []ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultEntityDnaEntityModificationOptional

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

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)

type ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultEntityLigandCcdEntity struct{…}

ChainIDs []string

Chain IDs for this ligand

Type LigandCcd

Value string

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

type ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultEntityLigandSmilesEntity struct{…}

ChainIDs []string

Chain IDs for this ligand

Type LigandSmiles

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).

minimum0

maximum1

LoopFraction float64

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

minimum0

maximum1

SheetFraction float64

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

minimum0

maximum1

StructureConfidence float64

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

Type Generic

Warnings []ProteinSequenceRedesignListResultsResponseGenericProteinDesignResultWarningOptional

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

Get redesigned protein sequences

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)
}

{
  "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"
}

Returns Examples

{
  "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"
}