List pipeline results from a share link

share_links.list_pipeline_results(, ) -> SyncCursorPage[ShareLinkListPipelineResultsResponse]

GET/compute/v1/share/{id}/pipelines/{pipelineId}/results

Paginated results for one pipeline exposed by a share link. The response shape matches the authed pipeline-results endpoints exactly. Access is gated by the share-link ID and — for email-mode links — a signed compute-API JWT. Pipeline IDs not covered by the link return 404 indistinguishably from unknown links.

ParametersExpand Collapse

id: str

pipeline_id: str

after_id: Optional[str]

Return results after this ID

before_id: Optional[str]

Return results before this ID

ids: Optional[str]

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: Optional[int]

Max results to return. Defaults to 100.

minimum1

maximum1000

ReturnsExpand Collapse

class ShareLinkListPipelineResultsResponse: …

A single generated protein design

id: str

Unique result ID.

artifacts: Artifacts

archive: ArtifactsArchive

url: str

URL to download the file

formaturi

url_expires_at: datetime

When the presigned URL expires

formatdate-time

structure: Optional[ArtifactsStructure]

url: str

URL to download the file

formaturi

url_expires_at: datetime

When the presigned URL expires

formatdate-time

created_at: datetime

formatdate-time

entities: List[Entity]

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

One of the following:

class EntityProteinEntity: …

chain_ids: List[str]

Chain IDs for this entity

type: Literal["protein"]

value: str

Amino acid sequence (one-letter codes)

cyclic: Optional[bool]

Whether the sequence is cyclic

modifications: Optional[List[EntityProteinEntityModification]]

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

residue_index: int

0-based index of the residue to modify

minimum0

type: Literal["ccd"]

Modification format. Only CCD polymer modifications are supported.

value: str

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

class EntityRnaEntity: …

chain_ids: List[str]

Chain IDs for this entity

type: Literal["rna"]

value: str

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

cyclic: Optional[bool]

Whether the sequence is cyclic

modifications: Optional[List[EntityRnaEntityModification]]

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

residue_index: int

0-based index of the residue to modify

minimum0

type: Literal["ccd"]

Modification format. Only CCD polymer modifications are supported.

value: str

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

class EntityDnaEntity: …

chain_ids: List[str]

Chain IDs for this entity

type: Literal["dna"]

value: str

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

cyclic: Optional[bool]

Whether the sequence is cyclic

modifications: Optional[List[EntityDnaEntityModification]]

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

residue_index: int

0-based index of the residue to modify

minimum0

type: Literal["ccd"]

Modification format. Only CCD polymer modifications are supported.

value: str

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

class EntityLigandCcdEntity: …

chain_ids: List[str]

Chain IDs for this ligand

type: Literal["ligand_ccd"]

value: str

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

class EntityLigandSmilesEntity: …

chain_ids: List[str]

Chain IDs for this ligand

type: Literal["ligand_smiles"]

value: str

SMILES string representing the ligand

metrics: Metrics

Structural and binding quality metrics for a designed protein binder

binding_confidence: float

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

helix_fraction: float

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

minimum0

maximum1

iptm: float

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

loop_fraction: float

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

minimum0

maximum1

min_interaction_pae: float

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

sheet_fraction: float

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

minimum0

maximum1

structure_confidence: float

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

warnings: Optional[List[Warning]]

Warnings about potential quality issues with this result.

code: str

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

message: str

Human-readable description of the warning

List pipeline results from a share link

import os
from boltz_api import Boltz

client = Boltz(
    api_key=os.environ.get("BOLTZ_API_KEY"),  # This is the default and can be omitted
)
page = client.share_links.list_pipeline_results(
    pipeline_id="pipelineId",
    id="id",
)
page = page.data[0]
print(page.id)

{
  "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
      },
      "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
      },
      "warnings": [
        {
          "code": "code",
          "message": "message"
        }
      ]
    }
  ],
  "first_id": "first_id",
  "has_more": true,
  "last_id": "last_id"
}