Skip to content
Go to Boltz API

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

ParametersExpand Collapse
query ProteinSequenceRedesignListParams
AfterID param.Field[string]Optional

Return results after this ID

BeforeID param.Field[string]Optional

Return results before this ID

Limit param.Field[int64]Optional

Max items to return. Defaults to 100.

minimum1
maximum100
WorkspaceID param.Field[string]Optional

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.

ReturnsExpand Collapse
type ProteinSequenceRedesignListResponse struct{…}

Summary of a protein sequence redesign run.

ID string

Unique ProteinSequenceRedesignRunSummary identifier

CompletedAt Time
formatdate-time
CreatedAt Time
formatdate-time
DataDeletedAt Time

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

formatdate-time
DeprecatedEngine BoltzProteinRedesign
Use pipeline instead.

Deprecated. Use pipeline instead.

DeprecatedEngineVersion V2026_07_14
Use pipeline_version instead.

Deprecated. Use pipeline_version instead.

Error ProteinSequenceRedesignListResponseError
Code string

Machine-readable error code

Message string

Human-readable error message

Details anyOptional

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
PipelineVersion V2026_07_14
Progress ProteinSequenceRedesignListResponseProgress
NumProteinsGenerated int64

Number of protein binders generated so far

minimum0
TotalProteinsToGenerate int64

Total number of protein binders requested

minimum1
LatestResultID stringOptional

ID of the most recently generated result

StartedAt Time
formatdate-time
Status ProteinSequenceRedesignListResponseStatus
One of the following:
const ProteinSequenceRedesignListResponseStatusPending ProteinSequenceRedesignListResponseStatus = "pending"
const ProteinSequenceRedesignListResponseStatusRunning ProteinSequenceRedesignListResponseStatus = "running"
const ProteinSequenceRedesignListResponseStatusSucceeded ProteinSequenceRedesignListResponseStatus = "succeeded"
const ProteinSequenceRedesignListResponseStatusFailed ProteinSequenceRedesignListResponseStatus = "failed"
const ProteinSequenceRedesignListResponseStatusStopped ProteinSequenceRedesignListResponseStatus = "stopped"
StoppedAt Time
formatdate-time
WorkspaceID string

Workspace ID

IdempotencyKey stringOptional

Client-provided idempotency key

List protein sequence redesign runs

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)
}
{
  "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"
}
Returns Examples
{
  "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"
}