Create experiment

curl --request POST \
  --url https://foundry-api-public.adaptyvbio.com/experiments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "experiment_spec": {
    "experiment_type": "affinity",
    "antigen_concentrations": [
      123
    ],
    "method": "bli",
    "n_replicates": 1,
    "parameters": "<unknown>",
    "sequences": {},
    "target_id": "<string>"
  },
  "name": "<string>",
  "id": "<string>",
  "webhook_url": "<string>"
}
'

{
  "experiment_id": "<string>"
}

experiments

Create experiment

Creates a new experiment request for the Adaptyv Foundry platform.

The payload captures the target (catalog entry or approved custom material), antibody sequences, replicate plan, assay parameters, optional metadata, and an optional webhook for notifications. Newly created experiments remain in Draft so clients can review inputs and submit for internal approval before quoting and production. API-originated experiments are automatically assigned to the organization’s API submissions project for traceability.

ExperimentSpec fields

Field	Type	Description
`experiment_type`	string	Required. `affinity`, `screening`, or `thermostability`
`method`	string	Measurement method: `bli` (default) or `spr`
`target_id`	string	Target UUID from the catalog. Required for binding experiments.
`sequences`	object	Required. Map of sequence name to FASTA string
`n_replicates`	integer	Recommended. Technical replicates (min 1, default 3)
`antigen_concentrations`	array	Required for affinity. Molar concentrations, e.g. `[1e-9, 1e-8]`
`parameters`	object	Optional. Experiment-specific settings

Example: Affinity (BLI)

Full kinetic characterization measuring on/off rates and KD.

{
  "name": "CD20 affinity panel",
  "experiment_spec": {
    "experiment_type": "affinity",
    "method": "bli",
    "target_id": "550e8400-e29b-41d4-a716-446655440000",
    "sequences": {
      "rituximab_hc": "QVQLQQPGAELVKPGASVKMSCKAS...",
      "rituximab_lc": "QIVLSQSPAILSASPGEKVTMTC..."
    },
    "n_replicates": 3,
    "antigen_concentrations": [1e-9, 1e-8, 1e-7, 1e-6]
  },
  "webhook_url": "https://example.com/webhook"
}

Example: Screening (SPR)

High-throughput yes/no binding assessment using SPR.

{
  "name": "Library screening round 1",
  "experiment_spec": {
    "experiment_type": "screening",
    "method": "spr",
    "target_id": "550e8400-e29b-41d4-a716-446655440000",
    "sequences": {
      "clone_A1": "EVQLVESGGGLVQPGGSLRLSCAAS...",
      "clone_A2": "QVQLVQSGAEVKKPGASVKVSCKAS...",
      "clone_A3": "EVQLLESGGGLVQPGGSLRLSCAAS..."
    },
    "n_replicates": 2
  }
}

Example: Thermostability

Measures melting temperature (Tm) via differential scanning fluorimetry.

{
  "name": "Lead candidates stability",
  "experiment_spec": {
    "experiment_type": "thermostability",
    "sequences": {
      "candidate_1": "QVQLVQSGAEVKKPGAS...",
      "candidate_2": "EVQLVESGGGLVQPGGS..."
    },
    "n_replicates": 3,
    "parameters": {
      "buffer": "PBS",
      "ph": 7.4
    }
  }
}

POST

experiments

Create experiment

curl --request POST \
  --url https://foundry-api-public.adaptyvbio.com/experiments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "experiment_spec": {
    "experiment_type": "affinity",
    "antigen_concentrations": [
      123
    ],
    "method": "bli",
    "n_replicates": 1,
    "parameters": "<unknown>",
    "sequences": {},
    "target_id": "<string>"
  },
  "name": "<string>",
  "id": "<string>",
  "webhook_url": "<string>"
}
'

{
  "experiment_id": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request payload for creating or updating an experiment.

Supports upsert semantics: omit id to create a new experiment, or provide an existing experiment's UUID to update it. Created experiments start in Draft status. Updates replace sequences entirely rather than merging.

experiment_spec

object

required

Structured experiment definition (type, target, sequences, parameters)

Show child attributes

experiment_spec.experiment_type

enum<string>

required

Assay type: affinity, screening, or thermostability

Available options:

affinity,

screening,

thermostability

experiment_spec.antigen_concentrations

number<double>[] | null

Antigen concentrations to test (in Molar)

experiment_spec.method

enum<string>

Measurement method (BLI or SPR). Defaults to BLI.

Available options:

bli,

spr

experiment_spec.n_replicates

integer<int32> | null

Number of technical replicates (minimum 1, recommended 3+)

Required range: x >= 0

experiment_spec.parameters

any

Additional experiment-specific parameters

experiment_spec.sequences

object

Sequences keyed by a human readable name. Accepts either simple FASTA strings or rich objects with control flags and metadata.

Show child attributes

experiment_spec.sequences.{key}

Flexible sequence input for experiment creation.

Accepts a simple FASTA string or a rich object with control flag and metadata.

experiment_spec.target_id

string | null

UUID of the target antigen from the catalog

name

string

required

Human-readable name for the experiment

string | null

Experiment UUID for updates. Omit to create a new experiment.

webhook_url

string | null

URL to which experiment status updates will be POSTed

Response

Experiment updated successfully (when id provided)

Response confirming experiment creation.

experiment_id

string

required

Unique identifier assigned to the new experiment

List experiments Get experiment

Getting Started

API Endpoints

Create experiment

ExperimentSpec fields

Example: Affinity (BLI)

Example: Screening (SPR)

Example: Thermostability

Authorizations

Body

Response