adaptyv

1# Adaptyv Bio Foundry API
2 
3Use this skill to turn protein sequences into experimentally measured data through
4Adaptyv's cloud laboratory. Confirm the target construct, assay conditions, controls,
5and replicate plan before submitting a batch; turnaround depends on the experiment.
6 
7Reviewed against the deployed [OpenAPI schema](https://devs.adaptyvbio.com/api/v1/openapi.json)
8(`info.version: 0.0.2`) and official SDK `0.1.0` at commit
9`cdf207819ed5a58e0c127453626d2bce125c8064`. The schema version alone does not identify
10all changes. See the [endpoint reference](references/api-endpoints.md) for current
11request/response details and discrepancies in upstream examples.
12 
13## Connect
14 
15**Base URL:** `https://devs.adaptyvbio.com/api/v1`. The schema is at
16`/openapi.json`; never append that filename to normal endpoint requests.
17 
18Create a bearer token in [Foundry](https://foundry.adaptyvbio.com/) under
19Organization → Settings → Tokens. Use Viewer for reads and Member for experiment
20writes. Read credentials from `ADAPTYV_API_KEY`; the documentation's
21`FOUNDRY_API_TOKEN` is an alternative variable name for the same token. If using a
22project `.env`, explicitly call `python-dotenv.load_dotenv()` before SDK setup;
23the SDK does not load that file automatically. Never print or commit tokens.
24 
25```bash
26# ADAPTYV_API_KEY is already set in the environment.
27curl --fail-with-body 'https://devs.adaptyvbio.com/api/v1/targets?limit=3' \
28  -H "Authorization: Bearer $ADAPTYV_API_KEY"
29```
30…