{"openapi":"3.1.0","info":{"title":"Boltz score sharing API","description":"API for sharing molecule validation scores","version":"0.1.0"},"paths":{"/api/v1/validations/batch":{"post":{"summary":"Create Batch Validations Endpoint","description":"Create multiple molecule and nanobody validations in batch","operationId":"create_batch_validations_endpoint_api_v1_validations_batch_post","parameters":[{"name":"X-API-Key","in":"header","required":true,"schema":{"type":"string","title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchValidationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchJobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/molecule-targets/{name}/{epoch}":{"get":{"summary":"Get Molecule Target Averages Endpoint","description":"Get averaged per-target metrics for a molecule","operationId":"get_molecule_target_averages_endpoint_api_v1_molecule_targets__name___epoch__get","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}},{"name":"epoch","in":"path","required":true,"schema":{"type":"integer","title":"Epoch"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoleculeTargetAveragesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/molecules":{"get":{"summary":"Get Molecules Endpoint","description":"Get paginated list of molecules","operationId":"get_molecules_endpoint_api_v1_molecules_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_MoleculeResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/nanobodies/{sequence_hash}/{epoch}":{"get":{"summary":"Get Nanobody Target Averages Endpoint","description":"Get averaged per-target metrics for a nanobody","operationId":"get_nanobody_target_averages_endpoint_api_v1_nanobodies__sequence_hash___epoch__get","parameters":[{"name":"sequence_hash","in":"path","required":true,"schema":{"type":"string","title":"Sequence Hash"}},{"name":"epoch","in":"path","required":true,"schema":{"type":"integer","title":"Epoch"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NanobodyTargetAveragesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/molecule-targets/{name}/{epoch}/validations":{"get":{"summary":"Get Molecule Target Validations Endpoint","description":"Get raw per-validator molecule target validations","operationId":"get_molecule_target_validations_endpoint_api_v1_molecule_targets__name___epoch__validations_get","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}},{"name":"epoch","in":"path","required":true,"schema":{"type":"integer","title":"Epoch"}},{"name":"X-API-Key","in":"header","required":true,"schema":{"type":"string","title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoleculeTargetValidationsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/nanobodies/{sequence_hash}/{epoch}/validations":{"get":{"summary":"Get Nanobody Validations Endpoint","description":"Get raw per-validator nanobody validations","operationId":"get_nanobody_validations_endpoint_api_v1_nanobodies__sequence_hash___epoch__validations_get","parameters":[{"name":"sequence_hash","in":"path","required":true,"schema":{"type":"string","title":"Sequence Hash"}},{"name":"epoch","in":"path","required":true,"schema":{"type":"integer","title":"Epoch"}},{"name":"X-API-Key","in":"header","required":true,"schema":{"type":"string","title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NanobodyValidationsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/jobs/{job_id}":{"get":{"summary":"Get Job Status","description":"Check the status of a background job","operationId":"get_job_status_api_v1_jobs__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"integer","title":"Job Id"}},{"name":"X-API-Key","in":"header","required":true,"schema":{"type":"string","title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"BatchJobResponse":{"properties":{"job_id":{"type":"integer","title":"Job Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"}},"type":"object","required":["job_id","status","message"],"title":"BatchJobResponse"},"BatchValidationRequest":{"properties":{"epoch":{"type":"integer","exclusiveMinimum":0.0,"title":"Epoch","description":"Epoch number (must be positive)"},"molecules":{"anyOf":[{"items":{"$ref":"#/components/schemas/MoleculeTargetValidation"},"type":"array"},{"type":"null"}],"title":"Molecules"},"nanobodies":{"anyOf":[{"items":{"$ref":"#/components/schemas/NanobodyTargetValidation"},"type":"array"},{"type":"null"}],"title":"Nanobodies"}},"type":"object","required":["epoch"],"title":"BatchValidationRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"JobResponse":{"properties":{"id":{"type":"integer","title":"Id"},"status":{"type":"string","title":"Status"},"processed_count":{"type":"integer","title":"Processed Count"},"total_count":{"type":"integer","title":"Total Count"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","status","processed_count","total_count","error_message","created_at","updated_at"],"title":"JobResponse"},"MoleculeResponse":{"properties":{"name":{"type":"string","title":"Name"},"epoch":{"type":"integer","title":"Epoch"},"target_averages":{"additionalProperties":{"$ref":"#/components/schemas/TargetMetricAverages"},"type":"object","title":"Target Averages"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["name","epoch","target_averages","created_at"],"title":"MoleculeResponse"},"MoleculeTargetAveragesResponse":{"properties":{"name":{"type":"string","title":"Name"},"epoch":{"type":"integer","title":"Epoch"},"target_averages":{"additionalProperties":{"$ref":"#/components/schemas/TargetMetricAverages"},"type":"object","title":"Target Averages"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["name","epoch","target_averages","created_at"],"title":"MoleculeTargetAveragesResponse"},"MoleculeTargetValidation":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name","description":"Molecule reference in format rxn:digit:number:number or rxn:digit:number:number:number"},"target_protein":{"type":"string","maxLength":50,"minLength":1,"title":"Target Protein"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score"},"affinity_probability_binary":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Affinity Probability Binary"},"affinity_pred_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Affinity Pred Value"},"affinity_probability_binary1":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Affinity Probability Binary1"},"affinity_pred_value1":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Affinity Pred Value1"},"affinity_probability_binary2":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Affinity Probability Binary2"},"affinity_pred_value2":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Affinity Pred Value2"},"confidence_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence Score"},"ptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ptm"},"iptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Iptm"},"ligand_iptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ligand Iptm"},"protein_iptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Protein Iptm"},"complex_plddt":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Complex Plddt"},"complex_iplddt":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Complex Iplddt"},"complex_pde":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Complex Pde"},"complex_ipde":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Complex Ipde"}},"type":"object","required":["name","target_protein"],"title":"MoleculeTargetValidation"},"MoleculeTargetValidationAuditItem":{"properties":{"validator":{"$ref":"#/components/schemas/ValidatorPublicResponse"},"target_protein":{"type":"string","title":"Target Protein"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score"},"affinity_probability_binary":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Affinity Probability Binary"},"affinity_pred_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Affinity Pred Value"},"affinity_probability_binary1":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Affinity Probability Binary1"},"affinity_pred_value1":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Affinity Pred Value1"},"affinity_probability_binary2":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Affinity Probability Binary2"},"affinity_pred_value2":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Affinity Pred Value2"},"confidence_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence Score"},"ptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ptm"},"iptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Iptm"},"ligand_iptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ligand Iptm"},"protein_iptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Protein Iptm"},"complex_plddt":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Complex Plddt"},"complex_iplddt":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Complex Iplddt"},"complex_pde":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Complex Pde"},"complex_ipde":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Complex Ipde"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["validator","target_protein","created_at"],"title":"MoleculeTargetValidationAuditItem"},"MoleculeTargetValidationsResponse":{"properties":{"name":{"type":"string","title":"Name"},"epoch":{"type":"integer","title":"Epoch"},"validations":{"items":{"$ref":"#/components/schemas/MoleculeTargetValidationAuditItem"},"type":"array","title":"Validations"}},"type":"object","required":["name","epoch","validations"],"title":"MoleculeTargetValidationsResponse"},"NanobodyTargetAveragesResponse":{"properties":{"sequence_hash":{"type":"string","title":"Sequence Hash"},"epoch":{"type":"integer","title":"Epoch"},"target_averages":{"additionalProperties":{"$ref":"#/components/schemas/TargetMetricAverages"},"type":"object","title":"Target Averages"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["sequence_hash","epoch","target_averages","created_at"],"title":"NanobodyTargetAveragesResponse"},"NanobodyTargetValidation":{"properties":{"sequence_hash":{"type":"string","maxLength":255,"minLength":1,"title":"Sequence Hash"},"target_protein":{"type":"string","maxLength":50,"minLength":1,"title":"Target Protein"},"design_iiptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Design Iiptm"},"design_ptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Design Ptm"},"design_to_target_iptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Design To Target Iptm"},"min_design_to_target_pae":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Design To Target Pae"},"interaction_pae":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Interaction Pae"},"plip_hbonds_refolded":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Plip Hbonds Refolded"},"plip_saltbridge_refolded":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Plip Saltbridge Refolded"},"delta_sasa_refolded":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta Sasa Refolded"},"liability_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Liability Score"},"liability_num_violations":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Liability Num Violations"}},"type":"object","required":["sequence_hash","target_protein"],"title":"NanobodyTargetValidation"},"NanobodyValidationAuditItem":{"properties":{"validator":{"$ref":"#/components/schemas/ValidatorPublicResponse"},"target_protein":{"type":"string","title":"Target Protein"},"design_iiptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Design Iiptm"},"design_ptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Design Ptm"},"design_to_target_iptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Design To Target Iptm"},"min_design_to_target_pae":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Design To Target Pae"},"interaction_pae":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Interaction Pae"},"plip_hbonds_refolded":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Plip Hbonds Refolded"},"plip_saltbridge_refolded":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Plip Saltbridge Refolded"},"delta_sasa_refolded":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta Sasa Refolded"},"liability_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Liability Score"},"liability_num_violations":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Liability Num Violations"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["validator","target_protein","created_at"],"title":"NanobodyValidationAuditItem"},"NanobodyValidationsResponse":{"properties":{"sequence_hash":{"type":"string","title":"Sequence Hash"},"epoch":{"type":"integer","title":"Epoch"},"validations":{"items":{"$ref":"#/components/schemas/NanobodyValidationAuditItem"},"type":"array","title":"Validations"}},"type":"object","required":["sequence_hash","epoch","validations"],"title":"NanobodyValidationsResponse"},"PaginatedResponse_MoleculeResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/MoleculeResponse"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"}},"type":"object","required":["items","total","page","page_size","total_pages"],"title":"PaginatedResponse[MoleculeResponse]"},"TargetMetricAverages":{"properties":{"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score"},"affinity_probability_binary":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Affinity Probability Binary"},"affinity_pred_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Affinity Pred Value"},"affinity_probability_binary1":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Affinity Probability Binary1"},"affinity_pred_value1":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Affinity Pred Value1"},"affinity_probability_binary2":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Affinity Probability Binary2"},"affinity_pred_value2":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Affinity Pred Value2"},"confidence_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence Score"},"ptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ptm"},"iptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Iptm"},"ligand_iptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ligand Iptm"},"protein_iptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Protein Iptm"},"complex_plddt":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Complex Plddt"},"complex_iplddt":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Complex Iplddt"},"complex_pde":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Complex Pde"},"complex_ipde":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Complex Ipde"},"design_iiptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Design Iiptm"},"design_ptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Design Ptm"},"design_to_target_iptm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Design To Target Iptm"},"min_design_to_target_pae":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Design To Target Pae"},"interaction_pae":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Interaction Pae"},"plip_hbonds_refolded":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Plip Hbonds Refolded"},"plip_saltbridge_refolded":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Plip Saltbridge Refolded"},"delta_sasa_refolded":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta Sasa Refolded"},"liability_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Liability Score"},"liability_num_violations":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Liability Num Violations"}},"type":"object","title":"TargetMetricAverages"},"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"},"ValidatorPublicResponse":{"properties":{"id":{"type":"integer","title":"Id"},"full_name":{"type":"string","title":"Full Name"}},"type":"object","required":["id","full_name"],"title":"ValidatorPublicResponse"}}}}