Workflows
Workflows Overview
Endpoint map for workflow creation, graph configuration, execution, status, logs, and task results.
This page gives a single endpoint map for the Workflows API and links to each operation page.
Authentication
Use your Fastfold API key:
Authorization: Bearer <YOUR_API_KEY>Endpoint map
The workflow endpoints documented below are sourced from openapi/workflows.yaml.
| Method | Path | Purpose | Docs |
|---|---|---|---|
POST | /v1/workflows | Create a workflow run (evolla_v1, calvados_openmm_v1, boltzgen_v1) | Create Workflow Run |
GET | /v1/workflows/{workflow_id} | Fetch workflow run details | Get Workflow Run |
PATCH | /v1/workflows/{workflow_id}/public | Toggle public visibility | Update Workflow Public |
GET | /v1/workflows/public/{workflow_id} | Read a public workflow run | Get Public Workflow Run |
POST | /v1/workflows/graph/add | Create graph shell (used by boltzgen_v1) | Create Workflow Graph |
GET | /v1/workflows/{workflow_id}/workflow.yml | Get serialized workflow YAML | Get Workflow YAML |
POST | /v1/workflows/{workflow_id}/workflow.yml | Replace graph from workflow YAML | Set Workflow YAML |
POST | /v1/workflows/execute | Execute a workflow by ID | Execute Workflow |
GET | /v1/workflows/status/{workflow_id} | Fetch workflow + task statuses | Get Workflow Status |
GET | /v1/workflows/logs/{workflow_id} | Fetch workflow logs | Get Workflow Logs |
GET | /v1/workflows/task-results/{workflow_id} | Fetch parsed task outputs/artifacts | Get Workflow Task Results |
GET | /v1/workflows/evolla/linked-previews | List linked Evolla previews for a fold source | Get Evolla Linked Previews |
GET | /v1/workflows/evolla/linked-history | Fetch linked Evolla history rows | Get Evolla Linked History |
PATCH | /v1/workflows/evolla/{workflow_id}/draft-question | Update initial question for DRAFT Evolla workflow | Update Evolla Draft Question |
GET | /v1/workflows/openmm/input-from-fold-job/preview | Preview resolved OpenMM fold inputs | Preview OpenMM Input From Fold Job |
Common call sequences
BoltzGen graph workflow
POST /v1/workflows/graph/addPOST /v1/workflows/{workflow_id}/workflow.ymlPOST /v1/workflows/executeGET /v1/workflows/status/{workflow_id}(poll)GET /v1/workflows/task-results/{workflow_id}- Optional:
GET /v1/workflows/logs/{workflow_id}
Evolla/OpenMM workflow
POST /v1/workflowsPOST /v1/workflows/execute(when required by workflow type)GET /v1/workflows/status/{workflow_id}(poll)GET /v1/workflows/task-results/{workflow_id}
Last updated on