# Kallima ## Docs - [Create Adc Design](https://docs.kallima.bio/api-reference/adc-designs/create-adc-design.md) - [Delete Adc Design](https://docs.kallima.bio/api-reference/adc-designs/delete-adc-design.md) - [Delete an ADC design](https://docs.kallima.bio/api-reference/adc-designs/delete-an-adc-design.md): Delete an ADC design. Idempotent at the candidate level — the parent candidate is untouched. - [Fetch an ADC design](https://docs.kallima.bio/api-reference/adc-designs/fetch-an-adc-design.md): Fetch a single ADC design. - [Get Adc Analysis](https://docs.kallima.bio/api-reference/adc-designs/get-adc-analysis.md): Compute (or re-compute) ADC developability analysis for a design. - [Get Adc Design](https://docs.kallima.bio/api-reference/adc-designs/get-adc-design.md) - [Get Catalogue](https://docs.kallima.bio/api-reference/adc-designs/get-catalogue.md): Return payload and linker reference catalogues. - [List Adc Designs](https://docs.kallima.bio/api-reference/adc-designs/list-adc-designs.md) - [List ADC designs for a candidate](https://docs.kallima.bio/api-reference/adc-designs/list-adc-designs-for-a-candidate.md): Cursor-paginated list of ADC designs under one candidate, newest-first. - [Reference catalogues for ADC payloads and linkers](https://docs.kallima.bio/api-reference/adc-designs/reference-catalogues-for-adc-payloads-and-linkers.md): Return the built-in payload and linker reference catalogues. - [Register a new ADC design](https://docs.kallima.bio/api-reference/adc-designs/register-a-new-adc-design.md): Register an ADC design under a therapeutic candidate. - [Run (or re-run) developability analysis for a design](https://docs.kallima.bio/api-reference/adc-designs/run-or-re-run-developability-analysis-for-a-design.md): Compute rule-based ADC developability analysis and persist it. - [Get Admin Stats](https://docs.kallima.bio/api-reference/admin/get-admin-stats.md): Platform-wide usage stats. Requires PLATFORM_ADMIN_EMAILS membership. - [Create Antigen](https://docs.kallima.bio/api-reference/antigens/create-antigen.md): Add a new antigen to a project. - [Delete an antigen](https://docs.kallima.bio/api-reference/antigens/delete-an-antigen.md): Delete an antigen. - [Delete Antigen](https://docs.kallima.bio/api-reference/antigens/delete-antigen.md): Delete an antigen. Fails if complex jobs reference it (ON DELETE RESTRICT via jobs.antigen_id SET NULL doesn't block the antigen row itself, but complex_results.antigen_id does). - [Fetch an antigen](https://docs.kallima.bio/api-reference/antigens/fetch-an-antigen.md): Fetch a single antigen by id. - [List Antigens](https://docs.kallima.bio/api-reference/antigens/list-antigens.md): List all antigens for a project. - [List antigens for a project](https://docs.kallima.bio/api-reference/antigens/list-antigens-for-a-project.md): Cursor-paginated list of antigens in one project, newest-first. - [Register a new antigen target](https://docs.kallima.bio/api-reference/antigens/register-a-new-antigen-target.md): Register an antigen for use in complex predictions. - [Create Token](https://docs.kallima.bio/api-reference/api-tokens/create-token.md): Create a new API token. The raw token is returned once — store it securely. - [List Tokens](https://docs.kallima.bio/api-reference/api-tokens/list-tokens.md): List all active (non-revoked) tokens for the caller's org. - [Revoke Token](https://docs.kallima.bio/api-reference/api-tokens/revoke-token.md): Revoke an API token. Revoked tokens are immediately rejected. - [List Audit Log](https://docs.kallima.bio/api-reference/audit/list-audit-log.md): Return paginated audit log entries for the caller's organization. - [Create Checkout Session](https://docs.kallima.bio/api-reference/billing/create-checkout-session.md): Create a Stripe Checkout session for the requested plan. - [Create Credit Pack Checkout](https://docs.kallima.bio/api-reference/billing/create-credit-pack-checkout.md): Start a Stripe Checkout in ``payment`` mode for a one-time credit pack. - [Create Portal Session](https://docs.kallima.bio/api-reference/billing/create-portal-session.md): Create a Stripe Customer Portal session for subscription management. - [Get Credit Catalog](https://docs.kallima.bio/api-reference/billing/get-credit-catalog.md): Public credit pricing table (costs, grants, packs). - [Get Credit History](https://docs.kallima.bio/api-reference/billing/get-credit-history.md): Paginated credit transaction history for the caller's org. - [Get Subscription](https://docs.kallima.bio/api-reference/billing/get-subscription.md): Return the caller's plan and current credit balances. - [Stripe Webhook](https://docs.kallima.bio/api-reference/billing/stripe-webhook.md): Handle Stripe webhook events. No JWT auth — verified by signature. - [Create Candidate](https://docs.kallima.bio/api-reference/candidates/create-candidate.md) - [Delete Candidate](https://docs.kallima.bio/api-reference/candidates/delete-candidate.md) - [Get Candidate](https://docs.kallima.bio/api-reference/candidates/get-candidate.md) - [Link Antigen](https://docs.kallima.bio/api-reference/candidates/link-antigen.md) - [Link Source Antibody](https://docs.kallima.bio/api-reference/candidates/link-source-antibody.md) - [List Candidates](https://docs.kallima.bio/api-reference/candidates/list-candidates.md) - [Unlink Antigen](https://docs.kallima.bio/api-reference/candidates/unlink-antigen.md) - [Unlink Source Antibody](https://docs.kallima.bio/api-reference/candidates/unlink-source-antibody.md) - [Update Candidate](https://docs.kallima.bio/api-reference/candidates/update-candidate.md) - [Download a codon export as FASTA, CSV, or GenBank](https://docs.kallima.bio/api-reference/codon-exports/download-a-codon-export-as-fasta-csv-or-genbank.md): Assemble and stream a single codon export in the requested format. - [Download Codon Exports](https://docs.kallima.bio/api-reference/codon-exports/download-codon-exports.md): Assemble and stream an archive of the requested exports in one format. - [Fetch a codon export](https://docs.kallima.bio/api-reference/codon-exports/fetch-a-codon-export.md): Fetch a single codon export. - [Get a codon export batch](https://docs.kallima.bio/api-reference/codon-exports/get-a-codon-export-batch.md): Fetch a batch row with its list of export IDs. - [List Codon Exports](https://docs.kallima.bio/api-reference/codon-exports/list-codon-exports.md): List codon exports, optionally scoped to a variant, newest first. - [List codon exports for a variant](https://docs.kallima.bio/api-reference/codon-exports/list-codon-exports-for-a-variant.md): Cursor-paginated list of codon exports under one variant, newest-first. - [List codon optimization strategies](https://docs.kallima.bio/api-reference/codon-exports/list-codon-optimization-strategies.md): Return the built-in codon optimization strategy catalogue. - [List Codon Strategies](https://docs.kallima.bio/api-reference/codon-exports/list-codon-strategies.md): Return registered codon optimization strategies. - [List Signal Peptides](https://docs.kallima.bio/api-reference/codon-exports/list-signal-peptides.md): Return built-in + org-custom signal peptides visible to the caller. - [List signal peptides](https://docs.kallima.bio/api-reference/codon-exports/list-signal-peptides-1.md): Return built-in and org-custom signal peptides visible to the caller. - [Submit a codon export batch](https://docs.kallima.bio/api-reference/codon-exports/submit-a-codon-export-batch.md): Submit one codon export job per variant in the batch. - [Submit Codon Export Batch](https://docs.kallima.bio/api-reference/codon-exports/submit-codon-export-batch.md): Create N codon_export jobs under one batch and kick them off. - [Cancel a pending complex prediction](https://docs.kallima.bio/api-reference/complex-predictions/cancel-a-pending-complex-prediction.md): Cancel a complex prediction that has not yet started executing. - [Fetch a complex prediction](https://docs.kallima.bio/api-reference/complex-predictions/fetch-a-complex-prediction.md): Fetch a single complex-prediction envelope. Typed ``results`` populate when ``status=completed``; ``error`` populates when ``status=failed``. - [List complex predictions for a variant](https://docs.kallima.bio/api-reference/complex-predictions/list-complex-predictions-for-a-variant.md): List complex predictions for one variant, newest-first. - [Submit a complex prediction job](https://docs.kallima.bio/api-reference/complex-predictions/submit-a-complex-prediction-job.md): Submit a Boltz-2 antibody-antigen complex prediction. - [Health Check](https://docs.kallima.bio/api-reference/health/health-check.md): Liveness probe. Returns 200 if the service is running. - [Batch-submit humanization jobs](https://docs.kallima.bio/api-reference/humanizations/batch-submit-humanization-jobs.md): Submit up to 50 humanization jobs in a single call. Always returns ``202 Accepted``; poll each job via ``GET /v1/humanizations/{id}``. ``Prefer: wait`` is not supported on the batch endpoint — synchronous execution of 50 jobs would exceed the request timeout. - [Cancel a pending humanization](https://docs.kallima.bio/api-reference/humanizations/cancel-a-pending-humanization.md): Cancel a humanization that has not yet started executing. - [Fetch a humanization](https://docs.kallima.bio/api-reference/humanizations/fetch-a-humanization.md): Fetch a single humanization envelope. Typed ``results`` populate when ``status=completed``; ``error`` populates when ``status=failed``. - [List humanizations for a variant](https://docs.kallima.bio/api-reference/humanizations/list-humanizations-for-a-variant.md): List humanizations for one variant, sorted newest-first. - [Submit a humanization job](https://docs.kallima.bio/api-reference/humanizations/submit-a-humanization-job.md): Submit a humanization pipeline run against a variant. Returns ``202 Accepted`` with ``status=pending``; poll ``GET /v1/humanizations/{id}`` until ``status=completed`` or ``failed``. - [Caller identity and credit balance](https://docs.kallima.bio/api-reference/identity/caller-identity-and-credit-balance.md): Return the resolved org, plan, and current credit balances for the caller's API token. - [Cancel a pending immunogenicity analysis](https://docs.kallima.bio/api-reference/immunogenicity-analyses/cancel-a-pending-immunogenicity-analysis.md): Cancel an immunogenicity analysis that has not yet started executing. - [Fetch an immunogenicity analysis](https://docs.kallima.bio/api-reference/immunogenicity-analyses/fetch-an-immunogenicity-analysis.md): Fetch a single immunogenicity-analysis envelope. Typed ``results`` populate when ``status=completed``; ``error`` populates when ``status=failed``. - [List immunogenicity analyses for a variant](https://docs.kallima.bio/api-reference/immunogenicity-analyses/list-immunogenicity-analyses-for-a-variant.md): List immunogenicity analyses for one variant, newest-first. - [Submit an immunogenicity analysis job](https://docs.kallima.bio/api-reference/immunogenicity-analyses/submit-an-immunogenicity-analysis-job.md): Submit an immunogenicity analysis against a variant. Returns ``202 Accepted`` with ``status=pending``; poll ``GET /v1/immunogenicity-analyses/{id}`` until terminal. - [Download Complex Pdb](https://docs.kallima.bio/api-reference/jobs/download-complex-pdb.md): Download the complex PDB for a complex prediction job. - [Download Pdb](https://docs.kallima.bio/api-reference/jobs/download-pdb.md): Download the PDB file for a structure prediction job. - [Fetch job results](https://docs.kallima.bio/api-reference/jobs/fetch-job-results.md): Fetch the typed results of a completed job. - [Fetch job status](https://docs.kallima.bio/api-reference/jobs/fetch-job-status.md): Fetch a job's status envelope. Poll until ``status`` transitions to ``completed`` or ``failed``, then fetch ``/v1/jobs/{id}/results`` to read the typed output. - [Fetch multiple job statuses](https://docs.kallima.bio/api-reference/jobs/fetch-multiple-job-statuses.md): Fetch the status of up to 100 jobs in a single round-trip. - [Get Job](https://docs.kallima.bio/api-reference/jobs/get-job.md): Fetch a job + its results. Frontend polls this while the job is running. - [List Jobs](https://docs.kallima.bio/api-reference/jobs/list-jobs.md): List jobs visible to the caller, optionally scoped to one variant. - [Submit a pipeline job](https://docs.kallima.bio/api-reference/jobs/submit-a-pipeline-job.md): Submit a pipeline job against a variant. Returns ``202 Accepted`` immediately with ``status=pending``; poll ``GET /v1/jobs/{id}`` for progress and ``GET /v1/jobs/{id}/results`` once ``status=completed``. - [Submit Job](https://docs.kallima.bio/api-reference/jobs/submit-job.md): Submit a pipeline job for a variant. Returns immediately (status=pending). - [Create Project](https://docs.kallima.bio/api-reference/projects/create-project.md) - [Delete Project](https://docs.kallima.bio/api-reference/projects/delete-project.md) - [Get Project](https://docs.kallima.bio/api-reference/projects/get-project.md) - [List Projects](https://docs.kallima.bio/api-reference/projects/list-projects.md) - [List projects](https://docs.kallima.bio/api-reference/projects/list-projects-1.md): List projects in the caller's organization. - [Update Project](https://docs.kallima.bio/api-reference/projects/update-project.md) - [Delete Account](https://docs.kallima.bio/api-reference/settings/delete-account.md): Permanently delete the caller's account and all associated data. - [Get Notification Prefs](https://docs.kallima.bio/api-reference/settings/get-notification-prefs.md): Return the caller's notification preferences (defaults to all-off). - [Update Notification Prefs](https://docs.kallima.bio/api-reference/settings/update-notification-prefs.md): Upsert the caller's notification preferences. - [Create Source Antibody](https://docs.kallima.bio/api-reference/source-antibodies/create-source-antibody.md): Register a new parental source antibody under a project. - [Delete Source Antibody](https://docs.kallima.bio/api-reference/source-antibodies/delete-source-antibody.md): Delete a source antibody. - [Fetch a source antibody](https://docs.kallima.bio/api-reference/source-antibodies/fetch-a-source-antibody.md): Fetch a source antibody by ID. - [Get Source Antibody](https://docs.kallima.bio/api-reference/source-antibodies/get-source-antibody.md) - [List Source Antibodies](https://docs.kallima.bio/api-reference/source-antibodies/list-source-antibodies.md): List source antibodies in a project. - [Register a source antibody](https://docs.kallima.bio/api-reference/source-antibodies/register-a-source-antibody.md): Register a new parental (source) antibody under a project. - [Update Source Antibody](https://docs.kallima.bio/api-reference/source-antibodies/update-source-antibody.md): Update name or notes on a source antibody. - [Cancel a pending stability analysis](https://docs.kallima.bio/api-reference/stability-analyses/cancel-a-pending-stability-analysis.md): Cancel a stability analysis that has not yet started executing. - [Fetch a stability analysis](https://docs.kallima.bio/api-reference/stability-analyses/fetch-a-stability-analysis.md): Fetch a single stability-analysis envelope. Typed ``results`` populate when ``status=completed``; ``error`` populates when ``status=failed``. - [List stability analyses for a variant](https://docs.kallima.bio/api-reference/stability-analyses/list-stability-analyses-for-a-variant.md): List stability analyses for one variant, newest-first. - [Submit a stability analysis job](https://docs.kallima.bio/api-reference/stability-analyses/submit-a-stability-analysis-job.md): Submit a stability analysis against a variant. Returns ``202 Accepted`` with ``status=pending``; poll ``GET /v1/stability-analyses/{id}`` until terminal. - [Cancel a pending structure prediction](https://docs.kallima.bio/api-reference/structure-predictions/cancel-a-pending-structure-prediction.md): Cancel a structure prediction that has not yet started executing. - [Fetch a structure prediction](https://docs.kallima.bio/api-reference/structure-predictions/fetch-a-structure-prediction.md): Fetch a single structure-prediction envelope. Typed ``results`` populate when ``status=completed``; ``error`` populates when ``status=failed``. - [List structure predictions for a variant](https://docs.kallima.bio/api-reference/structure-predictions/list-structure-predictions-for-a-variant.md): List structure predictions for one variant, newest-first. - [Submit a structure prediction job](https://docs.kallima.bio/api-reference/structure-predictions/submit-a-structure-prediction-job.md): Submit an ImmuneBuilder structure prediction against a variant. Returns ``202 Accepted`` with ``status=pending``; poll ``GET /v1/structure-predictions/{id}`` until terminal. - [Accept Invitation](https://docs.kallima.bio/api-reference/teams/accept-invitation.md): Accept an invitation token. The caller must be authenticated. - [Create Invitation](https://docs.kallima.bio/api-reference/teams/create-invitation.md): Invite someone to an org by email. Requires admin or owner. - [Get My Org](https://docs.kallima.bio/api-reference/teams/get-my-org.md): Return the caller's org id, name, and plan. - [List Invitations](https://docs.kallima.bio/api-reference/teams/list-invitations.md): List pending invitations for an org. Requires admin or owner. - [List Members](https://docs.kallima.bio/api-reference/teams/list-members.md): List all members of an org. Accessible to any member. - [Remove Member](https://docs.kallima.bio/api-reference/teams/remove-member.md): Remove a member from an org. Requires admin or owner. Members may also remove themselves (leave the org). - [Revoke Invitation](https://docs.kallima.bio/api-reference/teams/revoke-invitation.md): Revoke a pending invitation. Requires admin or owner. - [Update Member Role](https://docs.kallima.bio/api-reference/teams/update-member-role.md): Change a member's role. Requires admin or owner. - [Delete a therapeutic candidate](https://docs.kallima.bio/api-reference/therapeutic-candidates/delete-a-therapeutic-candidate.md): Delete a therapeutic candidate. - [Detach a source antibody from a candidate](https://docs.kallima.bio/api-reference/therapeutic-candidates/detach-a-source-antibody-from-a-candidate.md): Remove the junction row linking a source antibody to a candidate. - [Detach an antigen from a candidate](https://docs.kallima.bio/api-reference/therapeutic-candidates/detach-an-antigen-from-a-candidate.md): Remove the junction row linking an antigen to a candidate. - [Fetch a therapeutic candidate](https://docs.kallima.bio/api-reference/therapeutic-candidates/fetch-a-therapeutic-candidate.md): Fetch a single therapeutic candidate + its junction IDs. - [Link a source antibody to a candidate](https://docs.kallima.bio/api-reference/therapeutic-candidates/link-a-source-antibody-to-a-candidate.md): Attach a parental (source) antibody to the candidate. - [Link an antigen to a candidate](https://docs.kallima.bio/api-reference/therapeutic-candidates/link-an-antigen-to-a-candidate.md): Attach an antigen target to the candidate. - [List therapeutic candidates for a project](https://docs.kallima.bio/api-reference/therapeutic-candidates/list-therapeutic-candidates-for-a-project.md): Cursor-paginated list of therapeutic candidates in one project, newest-first. - [Register a new therapeutic candidate](https://docs.kallima.bio/api-reference/therapeutic-candidates/register-a-new-therapeutic-candidate.md): Register a therapeutic candidate under a project. - [Update a therapeutic candidate](https://docs.kallima.bio/api-reference/therapeutic-candidates/update-a-therapeutic-candidate.md): Partial update of a candidate's mutable metadata. - [Reserve a presigned upload slot](https://docs.kallima.bio/api-reference/uploads/reserve-a-presigned-upload-slot.md): Reserve an upload slot and return a presigned Supabase Storage URL. - [Create Variant](https://docs.kallima.bio/api-reference/variants/create-variant.md) - [Delete Variant](https://docs.kallima.bio/api-reference/variants/delete-variant.md) - [Fetch a variant](https://docs.kallima.bio/api-reference/variants/fetch-a-variant.md): Fetch a variant by ID. - [Get Variant](https://docs.kallima.bio/api-reference/variants/get-variant.md) - [List a variant's chains](https://docs.kallima.bio/api-reference/variants/list-a-variants-chains.md): List the chain sequences attached to a variant. - [List Variants](https://docs.kallima.bio/api-reference/variants/list-variants.md) - [Update Variant](https://docs.kallima.bio/api-reference/variants/update-variant.md) - [Fetch a delivery record](https://docs.kallima.bio/api-reference/webhook-deliveries/fetch-a-delivery-record.md): Fetch a single webhook delivery record. - [List delivery log for a webhook](https://docs.kallima.bio/api-reference/webhook-deliveries/list-delivery-log-for-a-webhook.md): List the delivery log for one webhook endpoint, newest first. - [Retry a delivery](https://docs.kallima.bio/api-reference/webhook-deliveries/retry-a-delivery.md): Re-fire a single delivery attempt immediately. - [Delete a webhook endpoint](https://docs.kallima.bio/api-reference/webhooks/delete-a-webhook-endpoint.md): Permanently delete a webhook endpoint. Pending deliveries are orphaned. - [Fetch a webhook endpoint](https://docs.kallima.bio/api-reference/webhooks/fetch-a-webhook-endpoint.md): Fetch a single webhook endpoint. Secret is omitted; rotate to get a new one. - [Fire a test event](https://docs.kallima.bio/api-reference/webhooks/fire-a-test-event.md): Send a ``webhook.test`` event to the registered endpoint immediately. - [List webhook endpoints](https://docs.kallima.bio/api-reference/webhooks/list-webhook-endpoints.md): List all registered webhook endpoints for the caller's org, newest first. - [Register a webhook endpoint](https://docs.kallima.bio/api-reference/webhooks/register-a-webhook-endpoint.md): Register a new HTTPS endpoint to receive Kallima events. - [Update a webhook endpoint](https://docs.kallima.bio/api-reference/webhooks/update-a-webhook-endpoint.md): Update URL, event filter, or enabled state. Pass ``rotate_secret=true`` to issue a new signing secret — the old one is immediately invalidated and the response body includes the new secret. - [Authentication](https://docs.kallima.bio/authentication.md): API tokens, authorization header, credits, rate limits, and error handling. - [Credits](https://docs.kallima.bio/credits.md): How Kallima's credit system works — costs, monthly grants, top-ups, and transaction history. - [ADC design](https://docs.kallima.bio/guides/adc-design.md): Register antibody-drug conjugate designs and run rule-based developability analysis. - [Batch humanization](https://docs.kallima.bio/guides/batch-humanization.md): Submit hundreds of variants in one call and collect results as they finish. - [Codon export](https://docs.kallima.bio/guides/codon-export.md): Generate codon-optimized CDS for CHO, HEK293, or other expression hosts. - [Complex prediction](https://docs.kallima.bio/guides/complex-prediction.md): Dock an antibody against an antigen target using Boltz-2 and get a PDB + confidence metrics. - [Immunogenicity analysis](https://docs.kallima.bio/guides/immunogenicity.md): Predict MHC-I, MHC-II, and B-cell epitope risk from sequence. - [Stability analysis](https://docs.kallima.bio/guides/stability-analysis.md): Predict ΔΔG, solubility, thermostability, and get stabilizing mutation suggestions. - [Structure prediction](https://docs.kallima.bio/guides/structure-prediction.md): Predict a 3D antibody structure from sequence and download the PDB. - [Webhooks](https://docs.kallima.bio/guides/webhooks.md): Receive HTTP notifications when jobs complete instead of polling. - [Introduction](https://docs.kallima.bio/introduction.md): What Kallima is and who it's for. - [Quickstart](https://docs.kallima.bio/quickstart.md): Humanize an antibody in under five minutes. ## OpenAPI Specs - [openapi](https://docs.kallima.bio/api-reference/openapi.json)