Skip to main content
POST
/
experiments
Create a new experiment in the Adaptyv Foundry platform.
curl --request POST \
  --url https://kq5jp7qj7wdqklhsxmovkzn4l40obksv.lambda-url.eu-central-1.on.aws/experiments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "antigen_concentrations": [
    123
  ],
  "description": "<string>",
  "n_replicates": 1,
  "name": "<string>",
  "parameters": "<any>",
  "sequences": [
    {
      "fasta": "<string>",
      "name": "<string>"
    }
  ],
  "target_id": "<string>",
  "webhook_url": "<string>"
}'
{
  "created": true,
  "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 a new experiment.

Defines all required information to initiate an experiment design. Created experiments start in Draft status for review before confirmation. All experiments are automatically assigned to the organization's "API Submissions" project.

​
name
string
required

Human-readable name for the experiment

​
sequences
object[]
required

Sequences to test against the target

​
target_id
string
required

Target identifier - can be either a UUID or prefixed format (e.g., "acro:UUID")

​
webhook_url
string
required

URL to which experiment status updates will be POSTed

​
antigen_concentrations
number[] | null

Antigen concentrations to test (in Molar)

​
description
string | null

Detailed description of experiment goals and methodology

​
n_replicates
integer | null

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

Required range: x >= 0
​
parameters
any

Additional experiment-specific parameters

Response

Experiment request created successfully

Response confirming experiment creation.

​
created
boolean
required

Confirmation that experiment was created

​
id
string
required

Unique identifier assigned to the new experiment request