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.
Pre-flight credit check. The endpoint checks that the org balance
covers len(items) × credit_cost before submitting any jobs. This
is a best-effort guard with a TOCTOU window — if credits are consumed
between the check and the loop, individual submit_job calls will
raise 402 and the batch stops. Jobs already submitted in that run
stay pending and are charged normally.
Cost: write — burns rate + quota, and debits 1 credit per item.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Kallima","colors":{"primary":"#0d9488","light":"#2dd4bf","dark":"#0f766e"},"logo":{"light":"https://mintcdn.com/kallima/5OoB3ZWLq-d9Ec7P/logo/light.svg?fit=max\u0026auto=format\u0026n=5OoB3ZWLq-d9Ec7P\u0026q=85\u0026s=ef181688fdc26886bac6ce20da552eaf","dark":"https://mintcdn.com/kallima/5OoB3ZWLq-d9Ec7P/logo/dark.svg?fit=max\u0026auto=format\u0026n=5OoB3ZWLq-d9Ec7P\u0026q=85\u0026s=2b933375aa0a2edaea873056573692b8"},"favicon":"https://mintlify.s3.us-west-1.amazonaws.com/kallima/favicon.ico","styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"kallima","hasAudioNarration":false,"actualSubdomain":"kallima","customDomains":["docs.kallima.bio"],"gitSource":{"type":"github","owner":"jbmcmahan","repo":"antibody","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21dda65ff9f1e2c50d25da","collectionId":"62bfe952-b846-44dd-9c56-e273feecf15e","schemaVersion":"v2"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a21dda65ff9f1e2c50d25da:success","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"API Reference","count":134},{"language":"default","tag":"adc-designs","count":12},{"language":"default","tag":"codon-exports","count":12},{"language":"default","tag":"candidates","count":9},{"language":"default","tag":"jobs","count":9},{"language":"default","tag":"therapeutic-candidates","count":9},{"language":"default","tag":"Guides","count":8},{"language":"default","tag":"teams","count":8},{"language":"default","tag":"antigens","count":7},{"language":"default","tag":"billing","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/humanizations/batch-submit-humanization-jobs","slug":"/api-reference/humanizations/batch-submit-humanization-jobs","pageMetadata":{"title":"Batch-submit humanization jobs","description":"Submit up to 50 humanization jobs in a single call. Always returns\n``202 Accepted``; poll each job via ``GET /v1/humanizations/{id}``.\n``Prefer: wait`` is not supported on the batch endpoint — synchronous\nexecution of 50 jobs would exceed the request timeout.\n\n**Pre-flight credit check.** The endpoint checks that the org balance\ncovers ``len(items) × credit_cost`` before submitting any jobs. This\nis a best-effort guard with a TOCTOU window — if credits are consumed\nbetween the check and the loop, individual ``submit_job`` calls will\nraise ``402`` and the batch stops. Jobs already submitted in that run\nstay ``pending`` and are charged normally.\n\nCost: **write** — burns rate + quota, and debits 1 credit per item.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/humanizations/batch","href":"/api-reference/humanizations/batch-submit-humanization-jobs","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Submit up to 50 humanization jobs in a single call. Always returns\\n\", _jsx(_components.code, {\n children: \"202 Accepted\"\n }), \"; poll each job via \", _jsx(_components.code, {\n children: \"GET /v1/humanizations/{id}\"\n }), \".\\n\", _jsx(_components.code, {\n children: \"Prefer: wait\"\n }), \" is not supported on the batch endpoint — synchronous\\nexecution of 50 jobs would exceed the request timeout.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Pre-flight credit check.\"\n }), \" The endpoint checks that the org balance\\ncovers \", _jsx(_components.code, {\n children: \"len(items) × credit_cost\"\n }), \" before submitting any jobs. This\\nis a best-effort guard with a TOCTOU window — if credits are consumed\\nbetween the check and the loop, individual \", _jsx(_components.code, {\n children: \"submit_job\"\n }), \" calls will\\nraise \", _jsx(_components.code, {\n children: \"402\"\n }), \" and the batch stops. Jobs already submitted in that run\\nstay \", _jsx(_components.code, {\n children: \"pending\"\n }), \" and are charged normally.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Cost: \", _jsx(_components.strong, {\n children: \"write\"\n }), \" — burns rate + quota, and debits 1 credit per item.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Batch-submit humanization jobs","description":"Submit up to 50 humanization jobs in a single call. Always returns\n``202 Accepted``; poll each job via ``GET /v1/humanizations/{id}``.\n``Prefer: wait`` is not supported on the batch endpoint — synchronous\nexecution of 50 jobs would exceed the request timeout.\n\n**Pre-flight credit check.** The endpoint checks that the org balance\ncovers ``len(items) × credit_cost`` before submitting any jobs. This\nis a best-effort guard with a TOCTOU window — if credits are consumed\nbetween the check and the loop, individual ``submit_job`` calls will\nraise ``402`` and the batch stops. Jobs already submitted in that run\nstay ``pending`` and are charged normally.\n\nCost: **write** — burns rate + quota, and debits 1 credit per item.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/humanizations/batch","href":"/api-reference/humanizations/batch-submit-humanization-jobs","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["humanizations"],"summary":"Batch-submit humanization jobs","description":"Submit up to 50 humanization jobs in a single call. Always returns\n``202 Accepted``; poll each job via ``GET /v1/humanizations/{id}``.\n``Prefer: wait`` is not supported on the batch endpoint — synchronous\nexecution of 50 jobs would exceed the request timeout.\n\n**Pre-flight credit check.** The endpoint checks that the org balance\ncovers ``len(items) × credit_cost`` before submitting any jobs. This\nis a best-effort guard with a TOCTOU window — if credits are consumed\nbetween the check and the loop, individual ``submit_job`` calls will\nraise ``402`` and the batch stops. Jobs already submitted in that run\nstay ``pending`` and are charged normally.\n\nCost: **write** — burns rate + quota, and debits 1 credit per item.","operationId":"batch_submit_humanizations_v1_humanizations_batch_post","requestBody":"07bed69c-e845-4b22-8405-c5ff63d954a9","responses":{"202":"2b7d4f56-3f8d-40ca-bbaf-81cb17dcd6fa","400":"97fa555f-623b-4247-92a3-a1ce0171797c","401":"f6ca62a5-c4e6-4088-a350-65db391abd4e","402":"c4af208f-495e-4288-9256-1b4eaf667f98","404":"eaaadbb1-a09a-4e49-9913-81833a4c6ed6","422":"89624de3-43a6-48ea-a39b-29ff51598b28","429":"e022a64c-55ed-4ace-a891-d23ee6dd0f6d"},"security":["824453e5-d922-4144-8800-0cec4fbe5f21"],"method":"post","type":"path","servers":[],"path":"/v1/humanizations/batch","baseUrlOptions":[],"title":"Batch-submit humanization jobs","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"properties":{"items":{"items":{"properties":{"variant_id":{"type":"string","title":"Variant Id","description":"UUID of the variant to humanize. Must belong to the caller's org. Strategy selection is not yet settable via the API — the pipeline runs all configured strategies on every submit.","examples":["11112222-3333-4444-5555-666677778888"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].variant_id","typeLabel":"string"}},"type":"object","required":["variant_id"],"title":"HumanizationSubmit","description":"Body for ``POST /v1/humanizations``.","example":{"variant_id":"11112222-3333-4444-5555-666677778888"},"uniqueKey":"\\items.items.[INDEX]","typeLabel":"HumanizationSubmit · object"},"type":"array","maxItems":50,"minItems":1,"title":"Items","description":"One to 50 humanization submit payloads.","isRequired":true,"uniqueKey":"\\items","typeLabel":"HumanizationSubmit · object[]"}},"type":"object","required":["items"],"title":"BatchHumanizationSubmit","description":"Body for ``POST /v1/humanizations/batch``.","uniqueKey":"","typeLabel":"BatchHumanizationSubmit · object"},"examples":{"Example":{"title":"Example","value":{"items":[{"variant_id":"11112222-3333-4444-5555-666677778888"}]}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"2b7d4f56-3f8d-40ca-bbaf-81cb17dcd6fa":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"items":{"items":{"properties":{"id":{"type":"string","title":"Id","description":"Opaque humanization identifier (UUID).","examples":["dddd1111-eeee-2222-ffff-333344445555"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].id","typeLabel":"string"},"status":{"type":"string","enum":["pending","running","completed","failed","canceled"],"title":"Status","description":"Lifecycle state. ``pending`` → ``running`` → ``completed`` | ``failed``. ``canceled`` is terminal and only reachable via ``POST /v1/humanizations/{id}/cancel`` on a still-pending job.","examples":["pending"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","title":"Created At","description":"ISO-8601 timestamp (UTC) when the job was submitted.","examples":["2026-04-22T14:15:00+00:00"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].created_at","typeLabel":"string"},"credit_cost":{"type":"integer","title":"Credit Cost","description":"Credits debited at submission for this job type.","examples":[1],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].credit_cost","typeLabel":"integer"},"inputs":{"properties":{"variant_id":{"type":"string","title":"Variant Id","description":"Variant the humanization ran against.","examples":["11112222-3333-4444-5555-666677778888"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].inputs.variant_id","typeLabel":"string"}},"type":"object","required":["variant_id"],"title":"HumanizationInputs","description":"Echo of the caller's submit body — useful for clients that don't cache.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].inputs","typeLabel":"HumanizationInputs · object"},"object":{"type":"string","const":"humanization","title":"Object","description":"Polymorphic discriminator. Always ``humanization`` on this endpoint.","default":"humanization","uniqueKey":"\\items.items.[INDEX].object","typeLabel":"string"},"started_at":{"oneOf":[{"type":"string","title":"Started At","description":"ISO-8601 timestamp when execution started. ``null`` while pending.","uniqueKey":"\\items.items.[INDEX].started_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Started At","description":"ISO-8601 timestamp when execution started. ``null`` while pending.","uniqueKey":"\\items.items.[INDEX].started_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].started_at","typeLabel":"string | null"},"completed_at":{"oneOf":[{"type":"string","title":"Completed At","description":"ISO-8601 timestamp when the job completed successfully. ``null`` otherwise.","uniqueKey":"\\items.items.[INDEX].completed_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Completed At","description":"ISO-8601 timestamp when the job completed successfully. ``null`` otherwise.","uniqueKey":"\\items.items.[INDEX].completed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].completed_at","typeLabel":"string | null"},"failed_at":{"oneOf":[{"type":"string","title":"Failed At","description":"ISO-8601 timestamp when the job failed. ``null`` unless ``status=failed``. Synthesized from the underlying job's terminal timestamp — the DB does not carry a separate ``failed_at`` column.","uniqueKey":"\\items.items.[INDEX].failed_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Failed At","description":"ISO-8601 timestamp when the job failed. ``null`` unless ``status=failed``. Synthesized from the underlying job's terminal timestamp — the DB does not carry a separate ``failed_at`` column.","uniqueKey":"\\items.items.[INDEX].failed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].failed_at","typeLabel":"string | null"},"canceled_at":{"oneOf":[{"type":"string","title":"Canceled At","description":"ISO-8601 timestamp when the job was canceled via ``POST /v1/humanizations/{id}/cancel``. ``null`` unless ``status=canceled``.","uniqueKey":"\\items.items.[INDEX].canceled_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Canceled At","description":"ISO-8601 timestamp when the job was canceled via ``POST /v1/humanizations/{id}/cancel``. ``null`` unless ``status=canceled``.","uniqueKey":"\\items.items.[INDEX].canceled_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].canceled_at","typeLabel":"string | null"},"error":{"oneOf":[{"type":"object","title":"HumanizationError","description":"Populated only when ``status=failed``. Same shape as problem+json.","required":["type","title","status","detail","code"],"properties":{"type":{"type":"string","title":"Type","description":"Stable URI identifying the error class.","examples":["https://docs.kallima.bio/errors/job_failed"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].error.oneOf.0.type","typeLabel":"string"},"title":{"type":"string","title":"Title","description":"Short human summary.","examples":["Job failed"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].error.oneOf.0.title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"HTTP-like status code.","examples":[500],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].error.oneOf.0.status","typeLabel":"integer"},"detail":{"type":"string","title":"Detail","description":"Human-readable failure reason, from the executor.","examples":["SequenceValidationError: VH must start with Q or E"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].error.oneOf.0.detail","typeLabel":"string"},"code":{"type":"string","title":"Code","description":"Machine-readable code. SDKs switch on this.","examples":["job_failed"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].error.oneOf.0.code","typeLabel":"string"}},"uniqueKey":"\\items.items.[INDEX].error.oneOf.0","typeLabel":"HumanizationError · object"},{"type":"null","description":"Populated only when ``status=failed``. Same shape as problem+json.","uniqueKey":"\\items.items.[INDEX].error.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].error","typeLabel":"HumanizationError · object | null"},"results":{"oneOf":[{"type":"array","items":{"properties":{"strategy":{"type":"string","title":"Strategy","description":"Humanization strategy that produced this row. One of ``cdr_grafting``, ``resurfacing``, ``sdr_grafting``, or ``germline``.","examples":["cdr_grafting"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].strategy","typeLabel":"string"},"humanized_vh":{"type":"string","title":"Humanized Vh","description":"Humanized heavy-chain variable region amino-acid sequence.","examples":["EVQLVESGGGLVQPGGSLRLSCAAS..."],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].humanized_vh","typeLabel":"string"},"humanized_vl":{"oneOf":[{"type":"string","title":"Humanized Vl","description":"Humanized light-chain variable region. ``null`` for nanobodies.","example":"DIQMTQSPSSLSASVGDRVTITCRASQ...","uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].humanized_vl.oneOf.0","typeLabel":"string"},{"type":"null","title":"Humanized Vl","description":"Humanized light-chain variable region. ``null`` for nanobodies.","example":"DIQMTQSPSSLSASVGDRVTITCRASQ...","uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].humanized_vl.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].humanized_vl","typeLabel":"string | null"},"oasis_score":{"oneOf":[{"type":"object","title":"Oasis Score","description":"OASis humanness score summary (``mean``, ``median``, per-chain breakdown).","example":{"mean":0.91,"median":0.93},"additionalProperties":true,"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].oasis_score.oneOf.0","typeLabel":"Oasis Score · object"},{"type":"null","title":"Oasis Score","description":"OASis humanness score summary (``mean``, ``median``, per-chain breakdown).","example":{"mean":0.91,"median":0.93},"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].oasis_score.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].oasis_score","typeLabel":"Oasis Score · object | null"},"mutations":{"oneOf":[{"type":"object","title":"Mutations","description":"Mutation counts + positions relative to the parent variant.","example":{"vh":12,"vl":8},"additionalProperties":true,"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].mutations.oneOf.0","typeLabel":"Mutations · object"},{"type":"null","title":"Mutations","description":"Mutation counts + positions relative to the parent variant.","example":{"vh":12,"vl":8},"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].mutations.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].mutations","typeLabel":"Mutations · object | null"},"liabilities":{"oneOf":[{"type":"object","title":"Liabilities","description":"Detected liability motifs (aggregation, deamidation, oxidation, …).","example":{"glycosylation":[],"oxidation":["H100"]},"additionalProperties":true,"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].liabilities.oneOf.0","typeLabel":"Liabilities · object"},{"type":"null","title":"Liabilities","description":"Detected liability motifs (aggregation, deamidation, oxidation, …).","example":{"glycosylation":[],"oxidation":["H100"]},"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].liabilities.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].liabilities","typeLabel":"Liabilities · object | null"},"numbering":{"oneOf":[{"type":"object","title":"Numbering","description":"Per-residue Kabat / IMGT numbering tables. Present when the pipeline emits them.","additionalProperties":true,"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].numbering.oneOf.0","typeLabel":"Numbering · object"},{"type":"null","title":"Numbering","description":"Per-residue Kabat / IMGT numbering tables. Present when the pipeline emits them.","uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].numbering.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].numbering","typeLabel":"Numbering · object | null"},"vhh_analysis":{"oneOf":[{"type":"object","title":"Vhh Analysis","description":"VHH-specific analysis (nanobodies only).","additionalProperties":true,"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].vhh_analysis.oneOf.0","typeLabel":"Vhh Analysis · object"},{"type":"null","title":"Vhh Analysis","description":"VHH-specific analysis (nanobodies only).","uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].vhh_analysis.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].vhh_analysis","typeLabel":"Vhh Analysis · object | null"},"scfv_analysis":{"oneOf":[{"type":"object","title":"Scfv Analysis","description":"scFv-specific analysis (scFv molecule type only).","additionalProperties":true,"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].scfv_analysis.oneOf.0","typeLabel":"Scfv Analysis · object"},{"type":"null","title":"Scfv Analysis","description":"scFv-specific analysis (scFv molecule type only).","uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].scfv_analysis.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].scfv_analysis","typeLabel":"Scfv Analysis · object | null"},"fc_analysis":{"oneOf":[{"type":"object","title":"Fc Analysis","description":"Fc-region analysis (when the parent variant includes Fc).","additionalProperties":true,"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].fc_analysis.oneOf.0","typeLabel":"Fc Analysis · object"},{"type":"null","title":"Fc Analysis","description":"Fc-region analysis (when the parent variant includes Fc).","uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].fc_analysis.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX].fc_analysis","typeLabel":"Fc Analysis · object | null"}},"type":"object","required":["strategy","humanized_vh"],"title":"HumanizationResultEntry","description":"One strategy row — a humanized antibody produced by the pipeline.","uniqueKey":"\\items.items.[INDEX].results.oneOf.0.items.[INDEX]","typeLabel":"HumanizationResultEntry · object"},"title":"Results","description":"Per-strategy humanization outputs. ``null`` until ``status=completed``; empty list is valid if the pipeline produced no viable strategies.","uniqueKey":"\\items.items.[INDEX].results.oneOf.0","typeLabel":"HumanizationResultEntry · object[]"},{"type":"null","title":"Results","description":"Per-strategy humanization outputs. ``null`` until ``status=completed``; empty list is valid if the pipeline produced no viable strategies.","uniqueKey":"\\items.items.[INDEX].results.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].results","typeLabel":"HumanizationResultEntry · object[] | null"}},"type":"object","required":["id","status","created_at","credit_cost","inputs"],"title":"Humanization","description":"Humanization job envelope — pipeline status + typed results.\n\nField layout matches the shared spec in ``docs/strategy/api-plan.md``\nso the next 5 resource-per-job-type endpoints can ship identical\nenvelopes and the Python SDK can define one ``Job`` base class.","example":{"completed_at":"2026-04-22T14:15:28+00:00","created_at":"2026-04-22T14:15:00+00:00","credit_cost":1,"id":"dddd1111-eeee-2222-ffff-333344445555","inputs":{"variant_id":"11112222-3333-4444-5555-666677778888"},"object":"humanization","results":[{"humanized_vh":"EVQLVESGGGLVQPGGSLRLSCAAS...","humanized_vl":"DIQMTQSPSSLSASVGDRVTITCRASQ...","liabilities":{"glycosylation":[],"oxidation":["H100"]},"mutations":{"vh":12,"vl":8},"oasis_score":{"mean":0.91,"median":0.93},"strategy":"cdr_grafting"}],"started_at":"2026-04-22T14:15:02+00:00","status":"completed"},"uniqueKey":"\\items.items.[INDEX]","typeLabel":"Humanization · object"},"type":"array","title":"Items","isRequired":true,"uniqueKey":"\\items","typeLabel":"Humanization · object[]"}},"type":"object","required":["items"],"title":"BatchHumanizationResponse","description":"Response for ``POST /v1/humanizations/batch``.","uniqueKey":"","typeLabel":"BatchHumanizationResponse · object"},"examples":{"Example":{"title":"Example","value":{"items":[{"completed_at":"2026-04-22T14:15:28+00:00","created_at":"2026-04-22T14:15:00+00:00","credit_cost":1,"id":"dddd1111-eeee-2222-ffff-333344445555","inputs":{"variant_id":"11112222-3333-4444-5555-666677778888"},"object":"humanization","results":[{"humanized_vh":"EVQLVESGGGLVQPGGSLRLSCAAS...","humanized_vl":"DIQMTQSPSSLSASVGDRVTITCRASQ...","liabilities":{"glycosylation":[],"oxidation":["H100"]},"mutations":{"vh":12,"vl":8},"oasis_score":{"mean":0.91,"median":0.93},"strategy":"cdr_grafting"}],"started_at":"2026-04-22T14:15:02+00:00","status":"completed"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"97fa555f-623b-4247-92a3-a1ce0171797c":{"description":"Malformed request body or parameter.","content":{"application/problem+json":{"schema":{"additionalProperties":true,"description":"RFC 9457 problem+json body returned by every non-2xx response.","example":{"code":"insufficient_credits","credit_balance":0,"credit_cost":1,"detail":"Humanization costs 1 credit; balance is 0.","instance":"/v1/jobs","request_id":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","status":402,"title":"Insufficient credits","type":"https://docs.kallima.bio/errors/insufficient_credits"},"properties":{"type":{"description":"Stable URI identifying the error class. Dereferenceable at docs.kallima.bio/errors/{code}.","examples":["https://docs.kallima.bio/errors/insufficient_credits"],"title":"Type","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"title":{"description":"Short human-readable summary of the error class.","examples":["Insufficient credits"],"title":"Title","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"description":"HTTP status code. Matches the response status line.","examples":[402],"title":"Status","type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"description":"Human-readable explanation with values substituted.","examples":["Humanization costs 1 credit; balance is 0."],"title":"Detail","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"description":"The specific request URI that failed.","examples":["/v1/jobs"],"title":"Instance","type":"string","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"code":{"description":"Machine-readable short code. SDKs switch on this, not on `title`. See app.errors.ErrorCode for the full taxonomy.","examples":["insufficient_credits"],"title":"Code","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"oneOf":[{"type":"string","title":"Request Id","description":"ULID stamped on every request. Include when contacting support.","example":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","uniqueKey":"request_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Request Id","description":"ULID stamped on every request. Include when contacting support.","example":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","uniqueKey":"request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"request_id","typeLabel":"string | null"}},"required":["type","title","status","detail","instance","code"],"title":"ProblemDetails","type":"object","uniqueKey":"","typeLabel":"ProblemDetails · object"},"examples":{"Example":{"title":"Example","value":{"code":"insufficient_credits","credit_balance":0,"credit_cost":1,"detail":"Humanization costs 1 credit; balance is 0.","instance":"/v1/jobs","request_id":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","status":402,"title":"Insufficient credits","type":"https://docs.kallima.bio/errors/insufficient_credits"}}},"exampleType":"generated"}},"exampleType":"generated"},"f6ca62a5-c4e6-4088-a350-65db391abd4e":{"description":"Missing or invalid API token.","content":{"application/problem+json":{"schema":{"additionalProperties":true,"description":"RFC 9457 problem+json body returned by every non-2xx response.","example":{"code":"insufficient_credits","credit_balance":0,"credit_cost":1,"detail":"Humanization costs 1 credit; balance is 0.","instance":"/v1/jobs","request_id":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","status":402,"title":"Insufficient credits","type":"https://docs.kallima.bio/errors/insufficient_credits"},"properties":{"type":{"description":"Stable URI identifying the error class. Dereferenceable at docs.kallima.bio/errors/{code}.","examples":["https://docs.kallima.bio/errors/insufficient_credits"],"title":"Type","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"title":{"description":"Short human-readable summary of the error class.","examples":["Insufficient credits"],"title":"Title","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"description":"HTTP status code. Matches the response status line.","examples":[402],"title":"Status","type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"description":"Human-readable explanation with values substituted.","examples":["Humanization costs 1 credit; balance is 0."],"title":"Detail","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"description":"The specific request URI that failed.","examples":["/v1/jobs"],"title":"Instance","type":"string","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"code":{"description":"Machine-readable short code. SDKs switch on this, not on `title`. See app.errors.ErrorCode for the full taxonomy.","examples":["insufficient_credits"],"title":"Code","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"oneOf":[{"type":"string","title":"Request Id","description":"ULID stamped on every request. Include when contacting support.","example":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","uniqueKey":"request_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Request Id","description":"ULID stamped on every request. Include when contacting support.","example":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","uniqueKey":"request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"request_id","typeLabel":"string | null"}},"required":["type","title","status","detail","instance","code"],"title":"ProblemDetails","type":"object","uniqueKey":"","typeLabel":"ProblemDetails · object"},"examples":{"Example":{"title":"Example","value":{"code":"insufficient_credits","credit_balance":0,"credit_cost":1,"detail":"Humanization costs 1 credit; balance is 0.","instance":"/v1/jobs","request_id":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","status":402,"title":"Insufficient credits","type":"https://docs.kallima.bio/errors/insufficient_credits"}}},"exampleType":"generated"}},"exampleType":"generated"},"c4af208f-495e-4288-9256-1b4eaf667f98":{"description":"Payment required — insufficient credits or the caller's plan is below the required tier.","content":{"application/problem+json":{"schema":{"additionalProperties":true,"description":"RFC 9457 problem+json body returned by every non-2xx response.","example":{"code":"insufficient_credits","credit_balance":0,"credit_cost":1,"detail":"Humanization costs 1 credit; balance is 0.","instance":"/v1/jobs","request_id":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","status":402,"title":"Insufficient credits","type":"https://docs.kallima.bio/errors/insufficient_credits"},"properties":{"type":{"description":"Stable URI identifying the error class. Dereferenceable at docs.kallima.bio/errors/{code}.","examples":["https://docs.kallima.bio/errors/insufficient_credits"],"title":"Type","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"title":{"description":"Short human-readable summary of the error class.","examples":["Insufficient credits"],"title":"Title","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"description":"HTTP status code. Matches the response status line.","examples":[402],"title":"Status","type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"description":"Human-readable explanation with values substituted.","examples":["Humanization costs 1 credit; balance is 0."],"title":"Detail","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"description":"The specific request URI that failed.","examples":["/v1/jobs"],"title":"Instance","type":"string","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"code":{"description":"Machine-readable short code. SDKs switch on this, not on `title`. See app.errors.ErrorCode for the full taxonomy.","examples":["insufficient_credits"],"title":"Code","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"oneOf":[{"type":"string","title":"Request Id","description":"ULID stamped on every request. Include when contacting support.","example":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","uniqueKey":"request_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Request Id","description":"ULID stamped on every request. Include when contacting support.","example":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","uniqueKey":"request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"request_id","typeLabel":"string | null"}},"required":["type","title","status","detail","instance","code"],"title":"ProblemDetails","type":"object","uniqueKey":"","typeLabel":"ProblemDetails · object"},"examples":{"Example":{"title":"Example","value":{"code":"insufficient_credits","credit_balance":0,"credit_cost":1,"detail":"Humanization costs 1 credit; balance is 0.","instance":"/v1/jobs","request_id":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","status":402,"title":"Insufficient credits","type":"https://docs.kallima.bio/errors/insufficient_credits"}}},"exampleType":"generated"}},"exampleType":"generated"},"eaaadbb1-a09a-4e49-9913-81833a4c6ed6":{"description":"Resource does not exist in the caller's organization.","content":{"application/problem+json":{"schema":{"additionalProperties":true,"description":"RFC 9457 problem+json body returned by every non-2xx response.","example":{"code":"insufficient_credits","credit_balance":0,"credit_cost":1,"detail":"Humanization costs 1 credit; balance is 0.","instance":"/v1/jobs","request_id":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","status":402,"title":"Insufficient credits","type":"https://docs.kallima.bio/errors/insufficient_credits"},"properties":{"type":{"description":"Stable URI identifying the error class. Dereferenceable at docs.kallima.bio/errors/{code}.","examples":["https://docs.kallima.bio/errors/insufficient_credits"],"title":"Type","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"title":{"description":"Short human-readable summary of the error class.","examples":["Insufficient credits"],"title":"Title","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"description":"HTTP status code. Matches the response status line.","examples":[402],"title":"Status","type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"description":"Human-readable explanation with values substituted.","examples":["Humanization costs 1 credit; balance is 0."],"title":"Detail","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"description":"The specific request URI that failed.","examples":["/v1/jobs"],"title":"Instance","type":"string","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"code":{"description":"Machine-readable short code. SDKs switch on this, not on `title`. See app.errors.ErrorCode for the full taxonomy.","examples":["insufficient_credits"],"title":"Code","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"oneOf":[{"type":"string","title":"Request Id","description":"ULID stamped on every request. Include when contacting support.","example":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","uniqueKey":"request_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Request Id","description":"ULID stamped on every request. Include when contacting support.","example":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","uniqueKey":"request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"request_id","typeLabel":"string | null"}},"required":["type","title","status","detail","instance","code"],"title":"ProblemDetails","type":"object","uniqueKey":"","typeLabel":"ProblemDetails · object"},"examples":{"Example":{"title":"Example","value":{"code":"insufficient_credits","credit_balance":0,"credit_cost":1,"detail":"Humanization costs 1 credit; balance is 0.","instance":"/v1/jobs","request_id":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","status":402,"title":"Insufficient credits","type":"https://docs.kallima.bio/errors/insufficient_credits"}}},"exampleType":"generated"}},"exampleType":"generated"},"89624de3-43a6-48ea-a39b-29ff51598b28":{"description":"Request failed validation.","content":{"application/problem+json":{"schema":{"additionalProperties":true,"description":"RFC 9457 problem+json body returned by every non-2xx response.","example":{"code":"insufficient_credits","credit_balance":0,"credit_cost":1,"detail":"Humanization costs 1 credit; balance is 0.","instance":"/v1/jobs","request_id":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","status":402,"title":"Insufficient credits","type":"https://docs.kallima.bio/errors/insufficient_credits"},"properties":{"type":{"description":"Stable URI identifying the error class. Dereferenceable at docs.kallima.bio/errors/{code}.","examples":["https://docs.kallima.bio/errors/insufficient_credits"],"title":"Type","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"title":{"description":"Short human-readable summary of the error class.","examples":["Insufficient credits"],"title":"Title","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"description":"HTTP status code. Matches the response status line.","examples":[402],"title":"Status","type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"description":"Human-readable explanation with values substituted.","examples":["Humanization costs 1 credit; balance is 0."],"title":"Detail","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"description":"The specific request URI that failed.","examples":["/v1/jobs"],"title":"Instance","type":"string","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"code":{"description":"Machine-readable short code. SDKs switch on this, not on `title`. See app.errors.ErrorCode for the full taxonomy.","examples":["insufficient_credits"],"title":"Code","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"oneOf":[{"type":"string","title":"Request Id","description":"ULID stamped on every request. Include when contacting support.","example":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","uniqueKey":"request_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Request Id","description":"ULID stamped on every request. Include when contacting support.","example":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","uniqueKey":"request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"request_id","typeLabel":"string | null"}},"required":["type","title","status","detail","instance","code"],"title":"ProblemDetails","type":"object","uniqueKey":"","typeLabel":"ProblemDetails · object"},"examples":{"Example":{"title":"Example","value":{"code":"insufficient_credits","credit_balance":0,"credit_cost":1,"detail":"Humanization costs 1 credit; balance is 0.","instance":"/v1/jobs","request_id":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","status":402,"title":"Insufficient credits","type":"https://docs.kallima.bio/errors/insufficient_credits"}}},"exampleType":"generated"}},"exampleType":"generated"},"e022a64c-55ed-4ace-a891-d23ee6dd0f6d":{"description":"Rate limit or monthly write quota exceeded. `Retry-After` holds the number of seconds until the next admitted request.","content":{"application/problem+json":{"schema":{"additionalProperties":true,"description":"RFC 9457 problem+json body returned by every non-2xx response.","example":{"code":"insufficient_credits","credit_balance":0,"credit_cost":1,"detail":"Humanization costs 1 credit; balance is 0.","instance":"/v1/jobs","request_id":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","status":402,"title":"Insufficient credits","type":"https://docs.kallima.bio/errors/insufficient_credits"},"properties":{"type":{"description":"Stable URI identifying the error class. Dereferenceable at docs.kallima.bio/errors/{code}.","examples":["https://docs.kallima.bio/errors/insufficient_credits"],"title":"Type","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"title":{"description":"Short human-readable summary of the error class.","examples":["Insufficient credits"],"title":"Title","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"description":"HTTP status code. Matches the response status line.","examples":[402],"title":"Status","type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"description":"Human-readable explanation with values substituted.","examples":["Humanization costs 1 credit; balance is 0."],"title":"Detail","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"description":"The specific request URI that failed.","examples":["/v1/jobs"],"title":"Instance","type":"string","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"code":{"description":"Machine-readable short code. SDKs switch on this, not on `title`. See app.errors.ErrorCode for the full taxonomy.","examples":["insufficient_credits"],"title":"Code","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"oneOf":[{"type":"string","title":"Request Id","description":"ULID stamped on every request. Include when contacting support.","example":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","uniqueKey":"request_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Request Id","description":"ULID stamped on every request. Include when contacting support.","example":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","uniqueKey":"request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"request_id","typeLabel":"string | null"}},"required":["type","title","status","detail","instance","code"],"title":"ProblemDetails","type":"object","uniqueKey":"","typeLabel":"ProblemDetails · object"},"examples":{"Example":{"title":"Example","value":{"code":"insufficient_credits","credit_balance":0,"credit_cost":1,"detail":"Humanization costs 1 credit; balance is 0.","instance":"/v1/jobs","request_id":"req_01JBX6Y6ZK6N8Q7YJ0F5VX2C3D","status":402,"title":"Insufficient credits","type":"https://docs.kallima.bio/errors/insufficient_credits"}}},"exampleType":"generated"}},"headers":{"Retry-After":{"description":"Seconds until the caller may retry. Present on 429 responses.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Limit":{"description":"Per-minute rate ceiling for this API token's plan.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current rate window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"HTTP-date when the rate window resets.","schema":{"type":"string","format":"http-date"}},"X-Quota-Limit":{"description":"Monthly write ceiling for this API token's plan.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Writes remaining in the current monthly window.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"HTTP-date when the monthly write quota resets (always the 1st of next month UTC).","schema":{"type":"string","format":"http-date"}}},"exampleType":"generated"}},"security":{"824453e5-d922-4144-8800-0cec4fbe5f21":{"HTTPBearer":{"type":"http","scheme":"bearer","scopes":[]}}},"servers":{},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"HTTPBearer","name":"Authorization"}],"title":"HTTPBearer"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"kallima","siteName":"Kallima","title":"Batch-submit humanization jobs - Kallima","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-24T12:33:49.077Z","originalFileLocation":"api-reference/humanizations/batch-submit-humanization-jobs.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"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. Pre-flight credit check. The endpoint checks that the org balance covers len(items) × credit_cost before submitting any jobs. This is a best-effort guard with a TOCTOU window — if credits are consumed between the check and the loop, individual submit_job calls will raise 402 and the batch stops. Jobs already submitted in that run stay pending and are charged normally. Cost: write — burns rate + quota, and debits 1 credit per item.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Kallima\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/x-icon\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/kallima/favicon.ico\">\u003clink data-mint-head rel=\"icon\" type=\"image/x-icon\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/kallima/favicon.ico\">\u003clink data-mint-head rel=\"icon\" type=\"image/x-icon\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/kallima/favicon.ico\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/kallima/favicon.ico\">\u003cmeta data-mint-head property=\"og:title\" content=\"Batch-submit humanization jobs - Kallima\">\u003cmeta data-mint-head property=\"og:description\" content=\"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. Pre-flight credit check. The endpoint checks that the org balance covers len(items) × credit_cost before submitting any jobs. This is a best-effort guard with a TOCTOU window — if credits are consumed between the check and the loop, individual submit_job calls will raise 402 and the batch stops. Jobs already submitted in that run stay pending and are charged normally. Cost: write — burns rate + quota, and debits 1 credit per item.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Kallima\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.kallima.bio/api-reference/humanizations/batch-submit-humanization-jobs\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://kallima.mintlify.app/_mintlify/api/og/v2?division=humanizations\u0026amp;title=Batch-submit+humanization+jobs\u0026amp;description=Submit+up+to+50+humanization+jobs+in+a+single+call.+Always+returns%0A%60%60202+Accepted%60%60%3B+poll+each+job+via+%60%60GET+%2Fv1%2Fhumanizations%2F%7Bid%7D%60%60.%0A%60%60Prefer%3A+wait%60%60+is+not+s\u0026amp;theme=213cc913086101fd5955fc57\u0026amp;signature=49507474cd7e841bcb613c022d4ba372671dd0d1054a60bdc600a9a6bf7ec888\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Batch-submit humanization jobs - Kallima\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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. Pre-flight credit check. The endpoint checks that the org balance covers len(items) × credit_cost before submitting any jobs. This is a best-effort guard with a TOCTOU window — if credits are consumed between the check and the loop, individual submit_job calls will raise 402 and the batch stops. Jobs already submitted in that run stay pending and are charged normally. Cost: write — burns rate + quota, and debits 1 credit per item.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://kallima.mintlify.app/_mintlify/api/og/v2?division=humanizations\u0026amp;title=Batch-submit+humanization+jobs\u0026amp;description=Submit+up+to+50+humanization+jobs+in+a+single+call.+Always+returns%0A%60%60202+Accepted%60%60%3B+poll+each+job+via+%60%60GET+%2Fv1%2Fhumanizations%2F%7Bid%7D%60%60.%0A%60%60Prefer%3A+wait%60%60+is+not+s\u0026amp;theme=213cc913086101fd5955fc57\u0026amp;signature=49507474cd7e841bcb613c022d4ba372671dd0d1054a60bdc600a9a6bf7ec888\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/kallima/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Kallima\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0d9488\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.kallima.bio/api-reference/humanizations/batch-submit-humanization-jobs\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/humanizations/batch-submit-humanization-jobs.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.kallima.bio/#organization\",\"name\":\"Kallima\",\"url\":\"https://docs.kallima.bio\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/kallima/5OoB3ZWLq-d9Ec7P/logo/light.svg?fit=max\u0026auto=format\u0026n=5OoB3ZWLq-d9Ec7P\u0026q=85\u0026s=ef181688fdc26886bac6ce20da552eaf\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.kallima.bio#website\",\"name\":\"Kallima\",\"url\":\"https://docs.kallima.bio\",\"publisher\":{\"@id\":\"https://docs.kallima.bio/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.kallima.bio/api-reference/humanizations/batch-submit-humanization-jobs#webpage\",\"url\":\"https://docs.kallima.bio/api-reference/humanizations/batch-submit-humanization-jobs\",\"name\":\"Batch-submit humanization jobs\",\"description\":\"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. Pre-flight credit check. The endpoint checks that the org balance covers len(items) × credit_cost before submitting any jobs. This is a best-effort guard with a TOCTOU window — if credits are consumed between the check and the loop, individual submit_job calls will raise 402 and the batch stops. Jobs already submitted in that run stay pending and are charged normally. Cost: write — burns rate + quota, and debits 1 credit per item.\",\"dateModified\":\"2026-04-24T12:33:49.077Z\",\"isPartOf\":{\"@id\":\"https://docs.kallima.bio#website\"},\"breadcrumb\":{\"@id\":\"https://docs.kallima.bio/api-reference/humanizations/batch-submit-humanization-jobs#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.kallima.bio/api-reference/humanizations/batch-submit-humanization-jobs#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.kallima.bio/api-reference/health/health-check\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"humanizations\",\"item\":\"https://docs.kallima.bio/api-reference/humanizations/list-humanizations-for-a-variant\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Batch-submit humanization jobs\",\"item\":\"https://docs.kallima.bio/api-reference/humanizations/batch-submit-humanization-jobs\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.kallima.bio/api-reference/humanizations/batch-submit-humanization-jobs#apireference\",\"headline\":\"Batch-submit humanization jobs\",\"name\":\"Batch-submit humanization jobs\",\"description\":\"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. Pre-flight credit check. The endpoint checks that the org balance covers len(items) × credit_cost before submitting any jobs. This is a best-effort guard with a TOCTOU window — if credits are consumed between the check and the loop, individual submit_job calls will raise 402 and the batch stops. Jobs already submitted in that run stay pending and are charged normally. Cost: write — burns rate + quota, and debits 1 credit per item.\",\"url\":\"https://docs.kallima.bio/api-reference/humanizations/batch-submit-humanization-jobs\",\"mainEntityOfPage\":{\"@id\":\"https://docs.kallima.bio/api-reference/humanizations/batch-submit-humanization-jobs#webpage\"},\"dateModified\":\"2026-04-24T12:33:49.077Z\",\"publisher\":{\"@id\":\"https://docs.kallima.bio/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.kallima.bio#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Kallima\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Kallima","nav":{"global":null,"groups":[{"group":"Getting started","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Quickstart","href":"/quickstart"},{"title":"Authentication","href":"/authentication"},{"title":"Credits","href":"/credits"}]},{"group":"Guides","pages":[{"title":"Batch humanization","href":"/guides/batch-humanization"},{"title":"Structure prediction","href":"/guides/structure-prediction"},{"title":"Stability analysis","href":"/guides/stability-analysis"},{"title":"Immunogenicity analysis","href":"/guides/immunogenicity"},{"title":"Complex prediction","href":"/guides/complex-prediction"},{"title":"Codon export","href":"/guides/codon-export"},{"title":"ADC design","href":"/guides/adc-design"},{"title":"Webhooks","href":"/guides/webhooks"}]},{"group":"API Reference","pages":[{"group":"health","pages":[{"title":"Health Check","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /health","href":"/api-reference/health/health-check"}]},{"group":"projects","pages":[{"title":"List Projects","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /projects","href":"/api-reference/projects/list-projects"},{"title":"Create Project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /projects","href":"/api-reference/projects/create-project"},{"title":"Get Project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /projects/{project_id}","href":"/api-reference/projects/get-project"},{"title":"Delete Project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /projects/{project_id}","href":"/api-reference/projects/delete-project"},{"title":"Update Project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /projects/{project_id}","href":"/api-reference/projects/update-project"},{"title":"List projects","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects","href":"/api-reference/projects/list-projects-1"}]},{"group":"source-antibodies","pages":[{"title":"List Source Antibodies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /source-antibodies","href":"/api-reference/source-antibodies/list-source-antibodies"},{"title":"Create Source Antibody","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /source-antibodies","href":"/api-reference/source-antibodies/create-source-antibody"},{"title":"Get Source Antibody","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /source-antibodies/{source_antibody_id}","href":"/api-reference/source-antibodies/get-source-antibody"},{"title":"Delete Source Antibody","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /source-antibodies/{source_antibody_id}","href":"/api-reference/source-antibodies/delete-source-antibody"},{"title":"Update Source Antibody","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /source-antibodies/{source_antibody_id}","href":"/api-reference/source-antibodies/update-source-antibody"},{"title":"Register a source antibody","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/source-antibodies","href":"/api-reference/source-antibodies/register-a-source-antibody"},{"title":"Fetch a source antibody","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/source-antibodies/{source_antibody_id}","href":"/api-reference/source-antibodies/fetch-a-source-antibody"}]},{"group":"antigens","pages":[{"title":"List Antigens","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /antigens","href":"/api-reference/antigens/list-antigens"},{"title":"Create Antigen","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /antigens","href":"/api-reference/antigens/create-antigen"},{"title":"Delete Antigen","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /antigens/{antigen_id}","href":"/api-reference/antigens/delete-antigen"},{"title":"List antigens for a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/antigens","href":"/api-reference/antigens/list-antigens-for-a-project"},{"title":"Register a new antigen target","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/antigens","href":"/api-reference/antigens/register-a-new-antigen-target"},{"title":"Fetch an antigen","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/antigens/{antigen_id}","href":"/api-reference/antigens/fetch-an-antigen"},{"title":"Delete an antigen","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/antigens/{antigen_id}","href":"/api-reference/antigens/delete-an-antigen"}]},{"group":"candidates","pages":[{"title":"List Candidates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /candidates","href":"/api-reference/candidates/list-candidates"},{"title":"Create Candidate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /candidates","href":"/api-reference/candidates/create-candidate"},{"title":"Get Candidate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /candidates/{candidate_id}","href":"/api-reference/candidates/get-candidate"},{"title":"Delete Candidate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /candidates/{candidate_id}","href":"/api-reference/candidates/delete-candidate"},{"title":"Update Candidate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /candidates/{candidate_id}","href":"/api-reference/candidates/update-candidate"},{"title":"Link Source Antibody","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /candidates/{candidate_id}/source-antibodies/{source_antibody_id}","href":"/api-reference/candidates/link-source-antibody"},{"title":"Unlink Source Antibody","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /candidates/{candidate_id}/source-antibodies/{source_antibody_id}","href":"/api-reference/candidates/unlink-source-antibody"},{"title":"Link Antigen","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /candidates/{candidate_id}/antigens/{antigen_id}","href":"/api-reference/candidates/link-antigen"},{"title":"Unlink Antigen","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /candidates/{candidate_id}/antigens/{antigen_id}","href":"/api-reference/candidates/unlink-antigen"}]},{"group":"adc-designs","pages":[{"title":"Get Catalogue","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /adc-designs/catalogue","href":"/api-reference/adc-designs/get-catalogue"},{"title":"List Adc Designs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /adc-designs","href":"/api-reference/adc-designs/list-adc-designs"},{"title":"Create Adc Design","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /adc-designs","href":"/api-reference/adc-designs/create-adc-design"},{"title":"Get Adc Design","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /adc-designs/{design_id}","href":"/api-reference/adc-designs/get-adc-design"},{"title":"Delete Adc Design","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /adc-designs/{design_id}","href":"/api-reference/adc-designs/delete-adc-design"},{"title":"Get Adc Analysis","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /adc-designs/{design_id}/analysis","href":"/api-reference/adc-designs/get-adc-analysis"},{"title":"Reference catalogues for ADC payloads and linkers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/adc-designs/catalogue","href":"/api-reference/adc-designs/reference-catalogues-for-adc-payloads-and-linkers"},{"title":"List ADC designs for a candidate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/adc-designs","href":"/api-reference/adc-designs/list-adc-designs-for-a-candidate"},{"title":"Register a new ADC design","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/adc-designs","href":"/api-reference/adc-designs/register-a-new-adc-design"},{"title":"Fetch an ADC design","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/adc-designs/{design_id}","href":"/api-reference/adc-designs/fetch-an-adc-design"},{"title":"Delete an ADC design","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/adc-designs/{design_id}","href":"/api-reference/adc-designs/delete-an-adc-design"},{"title":"Run (or re-run) developability analysis for a design","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/adc-designs/{design_id}/analysis","href":"/api-reference/adc-designs/run-or-re-run-developability-analysis-for-a-design"}]},{"group":"variants","pages":[{"title":"List Variants","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /variants","href":"/api-reference/variants/list-variants"},{"title":"Create Variant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /variants","href":"/api-reference/variants/create-variant"},{"title":"Get Variant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /variants/{variant_id}","href":"/api-reference/variants/get-variant"},{"title":"Delete Variant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /variants/{variant_id}","href":"/api-reference/variants/delete-variant"},{"title":"Update Variant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /variants/{variant_id}","href":"/api-reference/variants/update-variant"},{"title":"Fetch a variant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/variants/{variant_id}","href":"/api-reference/variants/fetch-a-variant"},{"title":"List a variant's chains","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/variants/{variant_id}/chains","href":"/api-reference/variants/list-a-variants-chains"}]},{"group":"jobs","pages":[{"title":"List Jobs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /jobs","href":"/api-reference/jobs/list-jobs"},{"title":"Submit Job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /jobs","href":"/api-reference/jobs/submit-job"},{"title":"Get Job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /jobs/{job_id}","href":"/api-reference/jobs/get-job"},{"title":"Download Pdb","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /jobs/{job_id}/pdb","href":"/api-reference/jobs/download-pdb"},{"title":"Download Complex Pdb","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /jobs/{job_id}/complex-pdb","href":"/api-reference/jobs/download-complex-pdb"},{"title":"Fetch multiple job statuses","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/jobs","href":"/api-reference/jobs/fetch-multiple-job-statuses"},{"title":"Submit a pipeline job","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json post /v1/jobs","href":"/api-reference/jobs/submit-a-pipeline-job"},{"title":"Fetch job status","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json get /v1/jobs/{job_id}","href":"/api-reference/jobs/fetch-job-status"},{"title":"Fetch job results","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json get /v1/jobs/{job_id}/results","href":"/api-reference/jobs/fetch-job-results"}]},{"group":"codon-exports","pages":[{"title":"List Codon Strategies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /codon-strategies","href":"/api-reference/codon-exports/list-codon-strategies"},{"title":"List Signal Peptides","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /signal-peptides","href":"/api-reference/codon-exports/list-signal-peptides"},{"title":"Submit Codon Export Batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /codon-exports/batch","href":"/api-reference/codon-exports/submit-codon-export-batch"},{"title":"List Codon Exports","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /codon-exports","href":"/api-reference/codon-exports/list-codon-exports"},{"title":"Download Codon Exports","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /codon-exports/download","href":"/api-reference/codon-exports/download-codon-exports"},{"title":"List codon optimization strategies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/codon-exports/strategies","href":"/api-reference/codon-exports/list-codon-optimization-strategies"},{"title":"List signal peptides","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/codon-exports/signal-peptides","href":"/api-reference/codon-exports/list-signal-peptides-1"},{"title":"Submit a codon export batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/codon-exports/batches","href":"/api-reference/codon-exports/submit-a-codon-export-batch"},{"title":"Get a codon export batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/codon-exports/batches/{batch_id}","href":"/api-reference/codon-exports/get-a-codon-export-batch"},{"title":"List codon exports for a variant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/codon-exports","href":"/api-reference/codon-exports/list-codon-exports-for-a-variant"},{"title":"Fetch a codon export","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/codon-exports/{export_id}","href":"/api-reference/codon-exports/fetch-a-codon-export"},{"title":"Download a codon export as FASTA, CSV, or GenBank","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/codon-exports/{export_id}/download","href":"/api-reference/codon-exports/download-a-codon-export-as-fasta-csv-or-genbank"}]},{"group":"billing","pages":[{"title":"Get Subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /billing/subscription","href":"/api-reference/billing/get-subscription"},{"title":"Get Credit Catalog","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /billing/credits/catalog","href":"/api-reference/billing/get-credit-catalog"},{"title":"Get Credit History","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /billing/credits/history","href":"/api-reference/billing/get-credit-history"},{"title":"Create Checkout Session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /billing/checkout","href":"/api-reference/billing/create-checkout-session"},{"title":"Create Credit Pack Checkout","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /billing/credits/checkout","href":"/api-reference/billing/create-credit-pack-checkout"},{"title":"Create Portal Session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /billing/portal","href":"/api-reference/billing/create-portal-session"},{"title":"Stripe Webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /billing/webhook","href":"/api-reference/billing/stripe-webhook"}]},{"group":"teams","pages":[{"title":"Get My Org","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /orgs/me","href":"/api-reference/teams/get-my-org"},{"title":"List Members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /orgs/{org_id}/members","href":"/api-reference/teams/list-members"},{"title":"Remove Member","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /orgs/{org_id}/members/{target_user_id}","href":"/api-reference/teams/remove-member"},{"title":"Update Member Role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /orgs/{org_id}/members/{target_user_id}","href":"/api-reference/teams/update-member-role"},{"title":"List Invitations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /orgs/{org_id}/invitations","href":"/api-reference/teams/list-invitations"},{"title":"Create Invitation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /orgs/{org_id}/invitations","href":"/api-reference/teams/create-invitation"},{"title":"Revoke Invitation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /orgs/{org_id}/invitations/{invitation_id}","href":"/api-reference/teams/revoke-invitation"},{"title":"Accept Invitation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /invitations/{token}/accept","href":"/api-reference/teams/accept-invitation"}]},{"group":"api-tokens","pages":[{"title":"List Tokens","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api-tokens","href":"/api-reference/api-tokens/list-tokens"},{"title":"Create Token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api-tokens","href":"/api-reference/api-tokens/create-token"},{"title":"Revoke Token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api-tokens/{token_id}","href":"/api-reference/api-tokens/revoke-token"}]},{"group":"identity","pages":[{"title":"Caller identity and credit balance","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/me","href":"/api-reference/identity/caller-identity-and-credit-balance"}]},{"group":"humanizations","pages":[{"title":"List humanizations for a variant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/humanizations","href":"/api-reference/humanizations/list-humanizations-for-a-variant"},{"title":"Submit a humanization job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/humanizations","href":"/api-reference/humanizations/submit-a-humanization-job"},{"title":"Fetch a humanization","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/humanizations/{humanization_id}","href":"/api-reference/humanizations/fetch-a-humanization"},{"title":"Cancel a pending humanization","description":"Cancel a humanization that has not yet started executing.\n\n**Eligibility.** Only jobs with ``status=pending`` are cancelable.\nAnything else — ``running``, ``completed``, ``failed``, already\n``canceled`` — returns ``409 conflict``. In-flight cancel requires the\njob queue migration (FastAPI BackgroundTasks has no stop hook) and\nwill ship in a later PR.\n\n**Credits.** Cancel refunds the full submission cost to the\norganization's subscription bucket — the pipeline never ran, so the\ncustomer isn't charged.\n\nCross-resource scoping mirrors the fetch endpoint: a non-humanization\njob id returns ``404``.\n\nCost: **write** — burns rate + quota. Does not debit credits.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/humanizations/{humanization_id}/cancel","href":"/api-reference/humanizations/cancel-a-pending-humanization"},{"title":"Batch-submit humanization jobs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/humanizations/batch","href":"/api-reference/humanizations/batch-submit-humanization-jobs"}]},{"group":"structure-predictions","pages":[{"title":"List structure predictions for a variant","description":"List structure predictions for one variant, newest-first.\n\n``?variant_id=`` is required. The listed envelopes carry status +\ncredit_cost + inputs but **not** the typed ``results`` object;\nfetch the single resource with\n``GET /v1/structure-predictions/{id}`` for full output.\n\nCost: **read** — rate bucket only.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/structure-predictions","href":"/api-reference/structure-predictions/list-structure-predictions-for-a-variant"},{"title":"Submit a structure prediction job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/structure-predictions","href":"/api-reference/structure-predictions/submit-a-structure-prediction-job"},{"title":"Fetch a structure prediction","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/structure-predictions/{structure_prediction_id}","href":"/api-reference/structure-predictions/fetch-a-structure-prediction"},{"title":"Cancel a pending structure prediction","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/structure-predictions/{structure_prediction_id}/cancel","href":"/api-reference/structure-predictions/cancel-a-pending-structure-prediction"}]},{"group":"stability-analyses","pages":[{"title":"List stability analyses for a variant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/stability-analyses","href":"/api-reference/stability-analyses/list-stability-analyses-for-a-variant"},{"title":"Submit a stability analysis job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/stability-analyses","href":"/api-reference/stability-analyses/submit-a-stability-analysis-job"},{"title":"Fetch a stability analysis","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/stability-analyses/{stability_analysis_id}","href":"/api-reference/stability-analyses/fetch-a-stability-analysis"},{"title":"Cancel a pending stability analysis","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/stability-analyses/{stability_analysis_id}/cancel","href":"/api-reference/stability-analyses/cancel-a-pending-stability-analysis"}]},{"group":"immunogenicity-analyses","pages":[{"title":"List immunogenicity analyses for a variant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/immunogenicity-analyses","href":"/api-reference/immunogenicity-analyses/list-immunogenicity-analyses-for-a-variant"},{"title":"Submit an immunogenicity analysis job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/immunogenicity-analyses","href":"/api-reference/immunogenicity-analyses/submit-an-immunogenicity-analysis-job"},{"title":"Fetch an immunogenicity analysis","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/immunogenicity-analyses/{immunogenicity_analysis_id}","href":"/api-reference/immunogenicity-analyses/fetch-an-immunogenicity-analysis"},{"title":"Cancel a pending immunogenicity analysis","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/immunogenicity-analyses/{immunogenicity_analysis_id}/cancel","href":"/api-reference/immunogenicity-analyses/cancel-a-pending-immunogenicity-analysis"}]},{"group":"uploads","pages":[{"title":"Reserve a presigned upload slot","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/uploads","href":"/api-reference/uploads/reserve-a-presigned-upload-slot"}]},{"group":"complex-predictions","pages":[{"title":"List complex predictions for a variant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/complex-predictions","href":"/api-reference/complex-predictions/list-complex-predictions-for-a-variant"},{"title":"Submit a complex prediction job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/complex-predictions","href":"/api-reference/complex-predictions/submit-a-complex-prediction-job"},{"title":"Fetch a complex prediction","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/complex-predictions/{complex_prediction_id}","href":"/api-reference/complex-predictions/fetch-a-complex-prediction"},{"title":"Cancel a pending complex prediction","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/complex-predictions/{complex_prediction_id}/cancel","href":"/api-reference/complex-predictions/cancel-a-pending-complex-prediction"}]},{"group":"therapeutic-candidates","pages":[{"title":"List therapeutic candidates for a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/therapeutic-candidates","href":"/api-reference/therapeutic-candidates/list-therapeutic-candidates-for-a-project"},{"title":"Register a new therapeutic candidate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/therapeutic-candidates","href":"/api-reference/therapeutic-candidates/register-a-new-therapeutic-candidate"},{"title":"Fetch a therapeutic candidate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/therapeutic-candidates/{candidate_id}","href":"/api-reference/therapeutic-candidates/fetch-a-therapeutic-candidate"},{"title":"Delete a therapeutic candidate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/therapeutic-candidates/{candidate_id}","href":"/api-reference/therapeutic-candidates/delete-a-therapeutic-candidate"},{"title":"Update a therapeutic candidate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/therapeutic-candidates/{candidate_id}","href":"/api-reference/therapeutic-candidates/update-a-therapeutic-candidate"},{"title":"Link a source antibody to a candidate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/therapeutic-candidates/{candidate_id}/source-antibodies/{source_antibody_id}","href":"/api-reference/therapeutic-candidates/link-a-source-antibody-to-a-candidate"},{"title":"Detach a source antibody from a candidate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/therapeutic-candidates/{candidate_id}/source-antibodies/{source_antibody_id}","href":"/api-reference/therapeutic-candidates/detach-a-source-antibody-from-a-candidate"},{"title":"Link an antigen to a candidate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/therapeutic-candidates/{candidate_id}/antigens/{antigen_id}","href":"/api-reference/therapeutic-candidates/link-an-antigen-to-a-candidate"},{"title":"Detach an antigen from a candidate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/therapeutic-candidates/{candidate_id}/antigens/{antigen_id}","href":"/api-reference/therapeutic-candidates/detach-an-antigen-from-a-candidate"}]},{"group":"webhooks","pages":[{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/webhooks","href":"/api-reference/webhooks/list-webhook-endpoints"},{"title":"Register a webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/webhooks","href":"/api-reference/webhooks/register-a-webhook-endpoint"},{"title":"Fetch a webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/webhooks/{webhook_id}","href":"/api-reference/webhooks/fetch-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/webhooks/{webhook_id}","href":"/api-reference/webhooks/delete-a-webhook-endpoint"},{"title":"Update a webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/webhooks/{webhook_id}","href":"/api-reference/webhooks/update-a-webhook-endpoint"},{"title":"Fire a test event","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/webhooks/{webhook_id}/test","href":"/api-reference/webhooks/fire-a-test-event"}]},{"group":"webhook-deliveries","pages":[{"title":"List delivery log for a webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/webhook_deliveries","href":"/api-reference/webhook-deliveries/list-delivery-log-for-a-webhook"},{"title":"Fetch a delivery record","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/webhook_deliveries/{delivery_id}","href":"/api-reference/webhook-deliveries/fetch-a-delivery-record"},{"title":"Retry a delivery","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/webhook_deliveries/{delivery_id}/retry","href":"/api-reference/webhook-deliveries/retry-a-delivery"}]},{"group":"settings","pages":[{"title":"Get Notification Prefs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /settings/notifications","href":"/api-reference/settings/get-notification-prefs"},{"title":"Update Notification Prefs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /settings/notifications","href":"/api-reference/settings/update-notification-prefs"},{"title":"Delete Account","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /settings/account","href":"/api-reference/settings/delete-account"}]},{"group":"audit","pages":[{"title":"List Audit Log","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /audit","href":"/api-reference/audit/list-audit-log"}]},{"group":"admin","pages":[{"title":"Get Admin Stats","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /admin/stats","href":"/api-reference/admin/get-admin-stats"}]}]}]},"title":"Batch-submit humanization jobs - Kallima","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}