Skip to main content
POST
/
v1
/
adc-designs
/
{design_id}
/
analysis
Run (or re-run) developability analysis for a design
curl --request POST \
  --url https://api.example.com/v1/adc-designs/{design_id}/analysis \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "structure_job_id": "33aabbcc-4455-6677-8899-0011aabbccdd"
}
'
{
  "linker": {
    "linker_name": "<string>",
    "linker_type": "<string>",
    "cleavable": true,
    "release_trigger": "<string>",
    "plasma_stability": "<string>",
    "bystander_effect": true,
    "risk": "<string>",
    "warnings": [
      "<string>"
    ],
    "notes": "<string>"
  },
  "payload": {
    "payload_name": "<string>",
    "payload_class": "<string>",
    "mechanism": "<string>",
    "clogp": 123,
    "aggregation_risk": "<string>",
    "max_dar_tolerated": 123,
    "notes": "<string>"
  },
  "conjugation": {
    "method": "<string>",
    "dar_control": "<string>",
    "expected_dar": "<string>",
    "site_heterogeneity": "<string>",
    "stability": "<string>",
    "notes": "<string>"
  },
  "overall_risk": "<string>",
  "dar_mismatch_warning": "<string>",
  "conjugation_sites": [
    {
      "residue": "<string>",
      "chain": "<string>",
      "position": 123,
      "residue_type": "<string>",
      "relative_sasa": 123,
      "accessible": true,
      "note": "<string>"
    }
  ],
  "summary": "<string>"
}

Authorizations

Authorization
string
header
required

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

Path Parameters

design_id
string<uuid>
required

Body

application/json

Body for POST /v1/adc-designs/{id}/analysis.

structure_job_id
string | null

Optional structure-prediction job whose PDB should be loaded for conjugation-site SASA analysis. Must belong to the caller's org; cross-org ids return 404. Omit to run sequence-only rule-based analysis.

Example:

"33aabbcc-4455-6677-8899-0011aabbccdd"

Response

Successful Response

linker
LinkerAssessmentSchema · object
required
payload
PayloadAssessmentSchema · object
required
conjugation
ConjugationAssessmentSchema · object
required
overall_risk
string
required
dar_mismatch_warning
string | null
required
conjugation_sites
ConjugationSiteSchema · object[] | null
required
summary
string
required