> ## Documentation Index > Fetch the complete documentation index at: https://docs.kallima.bio/llms.txt > Use this file to discover all available pages before exploring further. # Get Adc Analysis > Compute (or re-compute) ADC developability analysis for a design. Pass ?structure_job_id= to include structure-based conjugation site accessibility analysis using the antibody PDB from that job. The result is also persisted back to adc_designs.analysis for caching. ## OpenAPI ````yaml /api-reference/openapi.json get /adc-designs/{design_id}/analysis openapi: 3.1.0 info: title: Kallima API description: >- Antibody design API — humanization, structure, stability, immunogenicity, complex prediction, and codon optimization. version: 0.1.0 servers: [] security: [] tags: - name: identity description: >- Caller identity and credit balance — use ``GET /v1/me`` to inspect the resolved org, plan, and compute budget before submitting jobs. - name: projects description: >- Projects — top-level containers for source antibodies and therapeutic candidates. - name: source-antibodies description: Source (parental) antibody sequences registered under a project. - name: variants description: >- Variants descended from a therapeutic candidate — the unit of work for pipelines. - name: jobs description: >- Long-running pipeline jobs: humanization, structure, stability, immunogenicity. Submit and poll. Deprecated in favor of resource-per-job-type endpoints (``humanizations`` and the other Phase 3 resources); scheduled for removal in ``/v2``. - name: humanizations description: >- Humanization pipeline runs — typed submit body and typed per-strategy results. First of the Phase 3 resource-per-job-type endpoints; the generic ``/v1/jobs`` shape is deprecated in favor of this. - name: structure-predictions description: >- ImmuneBuilder structure predictions — typed submit body and typed PDB / pLDDT / CDR results. Phase 3 resource-per-job-type endpoint. - name: stability-analyses description: >- Stability analyses — typed submit body and typed thermostability / aggregation / developability scorecard. Phase 3 resource-per-job-type endpoint. - name: immunogenicity-analyses description: >- Immunogenicity analyses — typed submit body and typed MHC-I / MHC-II / B-cell epitope + risk-score results. Phase 3 resource-per-job-type endpoint. - name: uploads description: >- Presigned Supabase Storage slots for caller-supplied files (e.g. antigen PDBs for complex prediction). The API never proxies bytes — clients PUT directly to the returned URL. - name: antigens description: >- Target protein sequences scoped to a project — the docking partner in a complex prediction. Register once, reference by ``antigen_id`` at submit time. - name: complex-predictions description: >- Boltz-2 antibody-antigen complex predictions — typed submit body and typed docked-PDB / iptm / interface-residues results. Phase 3 resource-per-job-type endpoint. Complex runs are long-running (~20–40 min on GPU); always poll, never hold the connection. - name: therapeutic-candidates description: >- Therapeutic candidates — the top-of-lineage object under a project. Creating one auto-creates a baseline variant (``v1``) and its chain rows atomically; pipelines submit against the variant. Junction endpoints manage many-to-many links to source antibodies and antigens. - name: adc-designs description: >- ADC (antibody-drug conjugate) designs — catalog records attaching a linker + payload + conjugation method to a therapeutic candidate. Run the rule-based developability analysis via ``POST /v1/adc-designs/{id}/analysis``; pass ``structure_job_id`` to include SASA-based conjugation-site accessibility. - name: codon-exports description: >- Codon optimization exports — submit a batch of jobs (one per variant), poll until ``variable_cds`` is populated, then download the assembled CDS as FASTA, CSV, or GenBank+ZIP. Requires the Structure plan or above. - name: webhooks description: >- Webhook endpoint registration — register HTTPS URLs to receive signed event deliveries when jobs complete or fail. Signing uses HMAC-SHA256; see ``POST /v1/webhooks`` for verification details. - name: webhook-deliveries description: >- Webhook delivery log — inspect past delivery attempts and manually retry failed ones via ``POST /v1/webhook_deliveries/{id}/retry``. paths: /adc-designs/{design_id}/analysis: get: tags: - adc-designs summary: Get Adc Analysis description: >- Compute (or re-compute) ADC developability analysis for a design. Pass ?structure_job_id= to include structure-based conjugation site accessibility analysis using the antibody PDB from that job. The result is also persisted back to adc_designs.analysis for caching. operationId: get_adc_analysis_adc_designs__design_id__analysis_get parameters: - name: design_id in: path required: true schema: type: string format: uuid title: Design Id - name: structure_job_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' title: Structure Job Id responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/AdcAnalysisResult' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] - HTTPBearer: [] components: schemas: AdcAnalysisResult: properties: linker: $ref: '#/components/schemas/LinkerAssessmentSchema' payload: $ref: '#/components/schemas/PayloadAssessmentSchema' conjugation: $ref: '#/components/schemas/ConjugationAssessmentSchema' overall_risk: type: string title: Overall Risk dar_mismatch_warning: anyOf: - type: string - type: 'null' title: Dar Mismatch Warning conjugation_sites: anyOf: - items: $ref: '#/components/schemas/ConjugationSiteSchema' type: array - type: 'null' title: Conjugation Sites summary: type: string title: Summary type: object required: - linker - payload - conjugation - overall_risk - dar_mismatch_warning - conjugation_sites - summary title: AdcAnalysisResult HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError LinkerAssessmentSchema: properties: linker_name: type: string title: Linker Name linker_type: type: string title: Linker Type cleavable: type: boolean title: Cleavable release_trigger: type: string title: Release Trigger plasma_stability: type: string title: Plasma Stability bystander_effect: type: boolean title: Bystander Effect risk: type: string title: Risk warnings: items: type: string type: array title: Warnings notes: type: string title: Notes type: object required: - linker_name - linker_type - cleavable - release_trigger - plasma_stability - bystander_effect - risk - warnings - notes title: LinkerAssessmentSchema PayloadAssessmentSchema: properties: payload_name: type: string title: Payload Name payload_class: type: string title: Payload Class mechanism: type: string title: Mechanism clogp: anyOf: - type: number - type: 'null' title: Clogp aggregation_risk: type: string title: Aggregation Risk max_dar_tolerated: anyOf: - type: integer - type: 'null' title: Max Dar Tolerated notes: type: string title: Notes type: object required: - payload_name - payload_class - mechanism - clogp - aggregation_risk - max_dar_tolerated - notes title: PayloadAssessmentSchema ConjugationAssessmentSchema: properties: method: type: string title: Method dar_control: type: string title: Dar Control expected_dar: type: string title: Expected Dar site_heterogeneity: type: string title: Site Heterogeneity stability: type: string title: Stability notes: type: string title: Notes type: object required: - method - dar_control - expected_dar - site_heterogeneity - stability - notes title: ConjugationAssessmentSchema ConjugationSiteSchema: properties: residue: type: string title: Residue chain: type: string title: Chain position: type: integer title: Position residue_type: type: string title: Residue Type relative_sasa: type: number title: Relative Sasa accessible: type: boolean title: Accessible note: type: string title: Note type: object required: - residue - chain - position - residue_type - relative_sasa - accessible - note title: ConjugationSiteSchema ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: HTTPBearer: type: http scheme: bearer ````