pipelines-public

Validate a pipeline run

Validate the settings and inputs of a run without creating or executing it. Uses the same settings as /submit.

Validates your pipeline to ensure compatible connections, required tool settings, and valid graph structure.

post/api/pipelines/validate

Request

  • Base URL: https://app.tamarind.bio
  • URL: https://app.tamarind.bio/api/pipelines/validate
  • Auth: API key in header x-api-key

Request body

pipelinePipelineIR

A pipeline IR document. Full schema (typed, versioned): https://tamarind.bio/schemas/pipeline-v1.json

templateIdstring nullable

REFERENCE mode: an existing template id to run.

namestring required

Name for this pipeline. When runName is omitted, the run's JobName is derived from this (spaces removed, a random suffix appended for uniqueness).

runNamestring nullable

Optional explicit JobName for THIS run. Spaces are replaced with underscores; used verbatim otherwise (no random suffix). Omit to auto-generate a unique JobName from name.

versionstring nullable

REFERENCE mode: a version handle e.g. 'v1'; absent -> default.

bindingsobject required

One binding per input slot, keyed by the slot's input-node id. Bindings may be defined as an array of sequences, smiles, or sdf/pdb files (uploaded using the /upload endpoint), or an existing molecule group id (created using /molecules/groups below).

settingsobject nullable

Per-node settings {nodeId: {settingKey: value}}. Chain and residue selections may be supplied here alongside ordinary settings. For existing templates, ordinary settings must be editable. Chain labels use reference space and follow chainMapping; inline residue selections must agree with overlapping binding selections.

source'production' | 'test'
projectstring nullable

Organization project id to stamp on jobs this run creates.

idempotencyKeystring nullable

Client key to safely retry a submit (≤255).

jobSourcestring nullable

Submission channel: "cli", "mcp", or "api". Ignored for session-authenticated callers.

Example request

{
  "bindings": {
    "target": {
      "group": "3f8a1c2e-5b7d-4e9f-a1b2-c3d4e5f6a7b8"
    }
  },
  "name": "binder-design v2 experiment",
  "project": "proj_…",
  "settings": {
    "design": {
      "numSequences": 32
    }
  },
  "templateId": "3f2a1c9e-8b7d-4e6f-a1b2-c3d4e5f60718",
  "version": "v1"
}

Response

Successful Response

validboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.