Skip to main content
POST
/
api
/
v1
/
experiments
/
{experiment_id}
/
submit
Submit experiment
curl --request POST \
  --url https://foundry-api-public.adaptyvbio.com/api/v1/experiments/{experiment_id}/submit \
  --header 'Authorization: Bearer <token>'
{
  "confirmed_at": "2026-02-15T14:30:00Z",
  "experiment_id": "019462a4-b1c2-7def-8901-23456789abcd",
  "previous_status": "draft",
  "status": "draft",
  "stripe_invoice_url": "https://invoice.stripe.com/i/acct_1234/test_5678"
}

Authorizations

​
Authorization
string
header
required

Biscuit-based bearer token. Obtain tokens from the Adaptyv Portal or via the /tokens endpoint. Tokens encode organization membership and role-based capabilities; the API verifies the token's cryptographic signature and authorization claims before processing requests. Use /tokens/attenuate to create restricted tokens for delegation.

Path Parameters

​
experiment_id
string<uuid>
required

Experiment identifier

Response

Experiment submitted for review

Confirmation response returned after a status transition via POST /confirm.

The confirm endpoint automatically advances the experiment through its lifecycle based on the current status. This response reports both the previous and new status so callers can verify what transition occurred.

​
confirmed_at
string<date-time>
required

RFC3339 timestamp when confirmation completed

Example:

"2026-02-15T14:30:00Z"

​
experiment_id
string<uuid>
required

Experiment identifier

Example:

"019462a4-b1c2-7def-8901-23456789abcd"

​
previous_status
enum<string>
required

Status before the transition

Available options:
draft,
waiting_for_confirmation,
canceled,
waiting_for_materials,
in_production,
quote_sent,
in_queue,
data_analysis,
in_review,
done
​
status
enum<string>
required

Status after the transition

Available options:
draft,
waiting_for_confirmation,
canceled,
waiting_for_materials,
in_production,
quote_sent,
in_queue,
data_analysis,
in_review,
done
​
stripe_invoice_url
string | null

Hosted invoice URL from Stripe (available after WaitingForConfirmation → WaitingForMaterials)

Example:

"https://invoice.stripe.com/i/acct_1234/test_5678"