Register a new therapeutic candidate
curl --request POST \
--url https://api.example.com/v1/therapeutic-candidates \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"antigen_ids": [
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
],
"description": "Humanized anti-HER2 lead",
"drug_class": "naked_antibody",
"format": "mab",
"initial_chains": [
{
"chain_id": "H",
"role": "heavy",
"variable_sequence": "QVQLV..."
},
{
"chain_id": "L",
"role": "light",
"variable_sequence": "DIQMTQ..."
}
],
"name": "anti-HER2 mab",
"project_id": "7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f",
"source_antibody_ids": [
"1111aaaa-2222-3333-4444-5555bbbbcccc"
]
}
'import requests
url = "https://api.example.com/v1/therapeutic-candidates"
payload = {
"antigen_ids": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
"description": "Humanized anti-HER2 lead",
"drug_class": "naked_antibody",
"format": "mab",
"initial_chains": [
{
"chain_id": "H",
"role": "heavy",
"variable_sequence": "QVQLV..."
},
{
"chain_id": "L",
"role": "light",
"variable_sequence": "DIQMTQ..."
}
],
"name": "anti-HER2 mab",
"project_id": "7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f",
"source_antibody_ids": ["1111aaaa-2222-3333-4444-5555bbbbcccc"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
antigen_ids: ['a1b2c3d4-e5f6-7890-abcd-ef1234567890'],
description: 'Humanized anti-HER2 lead',
drug_class: 'naked_antibody',
format: 'mab',
initial_chains: [
{chain_id: 'H', role: 'heavy', variable_sequence: 'QVQLV...'},
{chain_id: 'L', role: 'light', variable_sequence: 'DIQMTQ...'}
],
name: 'anti-HER2 mab',
project_id: '7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f',
source_antibody_ids: ['1111aaaa-2222-3333-4444-5555bbbbcccc']
})
};
fetch('https://api.example.com/v1/therapeutic-candidates', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v1/therapeutic-candidates",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'antigen_ids' => [
'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
],
'description' => 'Humanized anti-HER2 lead',
'drug_class' => 'naked_antibody',
'format' => 'mab',
'initial_chains' => [
[
'chain_id' => 'H',
'role' => 'heavy',
'variable_sequence' => 'QVQLV...'
],
[
'chain_id' => 'L',
'role' => 'light',
'variable_sequence' => 'DIQMTQ...'
]
],
'name' => 'anti-HER2 mab',
'project_id' => '7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f',
'source_antibody_ids' => [
'1111aaaa-2222-3333-4444-5555bbbbcccc'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/therapeutic-candidates"
payload := strings.NewReader("{\n \"antigen_ids\": [\n \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n ],\n \"description\": \"Humanized anti-HER2 lead\",\n \"drug_class\": \"naked_antibody\",\n \"format\": \"mab\",\n \"initial_chains\": [\n {\n \"chain_id\": \"H\",\n \"role\": \"heavy\",\n \"variable_sequence\": \"QVQLV...\"\n },\n {\n \"chain_id\": \"L\",\n \"role\": \"light\",\n \"variable_sequence\": \"DIQMTQ...\"\n }\n ],\n \"name\": \"anti-HER2 mab\",\n \"project_id\": \"7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f\",\n \"source_antibody_ids\": [\n \"1111aaaa-2222-3333-4444-5555bbbbcccc\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/v1/therapeutic-candidates")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"antigen_ids\": [\n \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n ],\n \"description\": \"Humanized anti-HER2 lead\",\n \"drug_class\": \"naked_antibody\",\n \"format\": \"mab\",\n \"initial_chains\": [\n {\n \"chain_id\": \"H\",\n \"role\": \"heavy\",\n \"variable_sequence\": \"QVQLV...\"\n },\n {\n \"chain_id\": \"L\",\n \"role\": \"light\",\n \"variable_sequence\": \"DIQMTQ...\"\n }\n ],\n \"name\": \"anti-HER2 mab\",\n \"project_id\": \"7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f\",\n \"source_antibody_ids\": [\n \"1111aaaa-2222-3333-4444-5555bbbbcccc\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/therapeutic-candidates")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"antigen_ids\": [\n \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n ],\n \"description\": \"Humanized anti-HER2 lead\",\n \"drug_class\": \"naked_antibody\",\n \"format\": \"mab\",\n \"initial_chains\": [\n {\n \"chain_id\": \"H\",\n \"role\": \"heavy\",\n \"variable_sequence\": \"QVQLV...\"\n },\n {\n \"chain_id\": \"L\",\n \"role\": \"light\",\n \"variable_sequence\": \"DIQMTQ...\"\n }\n ],\n \"name\": \"anti-HER2 mab\",\n \"project_id\": \"7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f\",\n \"source_antibody_ids\": [\n \"1111aaaa-2222-3333-4444-5555bbbbcccc\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"antigen_ids": [
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
],
"created_at": "2026-04-23T14:15:00+00:00",
"drug_class": "naked_antibody",
"format": "mab",
"format_metadata": {},
"id": "c0f5e4b1-a7d2-4e0b-9f8c-1b2d3e4f5a6b",
"initial_variant_id": "9999eeee-8888-dddd-7777-cccc66665555",
"name": "anti-HER2 mab",
"object": "therapeutic_candidate",
"project_id": "7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f",
"source_antibody_ids": [
"1111aaaa-2222-3333-4444-5555bbbbcccc"
],
"updated_at": "2026-04-23T14:15:00+00:00"
}{
"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"
}{
"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"
}{
"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"
}{
"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"
}{
"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"
}{
"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"
}therapeutic-candidates
Register a new therapeutic candidate
Register a therapeutic candidate under a project.
The service creates the candidate row, the baseline variant (v1),
its chain rows, and any source-antibody / antigen junction rows —
atomically. Any failure after the candidate insert rolls the
candidate row back, so the DB is never left with an orphaned
candidate. Cross-org references (source_antibody_ids,
antigen_ids, chain-level source_antibody_id /
constant_region_id) surface as 404 before any mutation.
Plan gate. None — registering candidates is free. Plan gates apply at submit time (humanization / structure / complex endpoints).
Cost: write — burns rate + quota. Does not debit credits.
POST
/
v1
/
therapeutic-candidates
Register a new therapeutic candidate
curl --request POST \
--url https://api.example.com/v1/therapeutic-candidates \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"antigen_ids": [
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
],
"description": "Humanized anti-HER2 lead",
"drug_class": "naked_antibody",
"format": "mab",
"initial_chains": [
{
"chain_id": "H",
"role": "heavy",
"variable_sequence": "QVQLV..."
},
{
"chain_id": "L",
"role": "light",
"variable_sequence": "DIQMTQ..."
}
],
"name": "anti-HER2 mab",
"project_id": "7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f",
"source_antibody_ids": [
"1111aaaa-2222-3333-4444-5555bbbbcccc"
]
}
'import requests
url = "https://api.example.com/v1/therapeutic-candidates"
payload = {
"antigen_ids": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
"description": "Humanized anti-HER2 lead",
"drug_class": "naked_antibody",
"format": "mab",
"initial_chains": [
{
"chain_id": "H",
"role": "heavy",
"variable_sequence": "QVQLV..."
},
{
"chain_id": "L",
"role": "light",
"variable_sequence": "DIQMTQ..."
}
],
"name": "anti-HER2 mab",
"project_id": "7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f",
"source_antibody_ids": ["1111aaaa-2222-3333-4444-5555bbbbcccc"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
antigen_ids: ['a1b2c3d4-e5f6-7890-abcd-ef1234567890'],
description: 'Humanized anti-HER2 lead',
drug_class: 'naked_antibody',
format: 'mab',
initial_chains: [
{chain_id: 'H', role: 'heavy', variable_sequence: 'QVQLV...'},
{chain_id: 'L', role: 'light', variable_sequence: 'DIQMTQ...'}
],
name: 'anti-HER2 mab',
project_id: '7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f',
source_antibody_ids: ['1111aaaa-2222-3333-4444-5555bbbbcccc']
})
};
fetch('https://api.example.com/v1/therapeutic-candidates', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v1/therapeutic-candidates",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'antigen_ids' => [
'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
],
'description' => 'Humanized anti-HER2 lead',
'drug_class' => 'naked_antibody',
'format' => 'mab',
'initial_chains' => [
[
'chain_id' => 'H',
'role' => 'heavy',
'variable_sequence' => 'QVQLV...'
],
[
'chain_id' => 'L',
'role' => 'light',
'variable_sequence' => 'DIQMTQ...'
]
],
'name' => 'anti-HER2 mab',
'project_id' => '7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f',
'source_antibody_ids' => [
'1111aaaa-2222-3333-4444-5555bbbbcccc'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/therapeutic-candidates"
payload := strings.NewReader("{\n \"antigen_ids\": [\n \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n ],\n \"description\": \"Humanized anti-HER2 lead\",\n \"drug_class\": \"naked_antibody\",\n \"format\": \"mab\",\n \"initial_chains\": [\n {\n \"chain_id\": \"H\",\n \"role\": \"heavy\",\n \"variable_sequence\": \"QVQLV...\"\n },\n {\n \"chain_id\": \"L\",\n \"role\": \"light\",\n \"variable_sequence\": \"DIQMTQ...\"\n }\n ],\n \"name\": \"anti-HER2 mab\",\n \"project_id\": \"7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f\",\n \"source_antibody_ids\": [\n \"1111aaaa-2222-3333-4444-5555bbbbcccc\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/v1/therapeutic-candidates")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"antigen_ids\": [\n \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n ],\n \"description\": \"Humanized anti-HER2 lead\",\n \"drug_class\": \"naked_antibody\",\n \"format\": \"mab\",\n \"initial_chains\": [\n {\n \"chain_id\": \"H\",\n \"role\": \"heavy\",\n \"variable_sequence\": \"QVQLV...\"\n },\n {\n \"chain_id\": \"L\",\n \"role\": \"light\",\n \"variable_sequence\": \"DIQMTQ...\"\n }\n ],\n \"name\": \"anti-HER2 mab\",\n \"project_id\": \"7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f\",\n \"source_antibody_ids\": [\n \"1111aaaa-2222-3333-4444-5555bbbbcccc\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/therapeutic-candidates")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"antigen_ids\": [\n \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n ],\n \"description\": \"Humanized anti-HER2 lead\",\n \"drug_class\": \"naked_antibody\",\n \"format\": \"mab\",\n \"initial_chains\": [\n {\n \"chain_id\": \"H\",\n \"role\": \"heavy\",\n \"variable_sequence\": \"QVQLV...\"\n },\n {\n \"chain_id\": \"L\",\n \"role\": \"light\",\n \"variable_sequence\": \"DIQMTQ...\"\n }\n ],\n \"name\": \"anti-HER2 mab\",\n \"project_id\": \"7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f\",\n \"source_antibody_ids\": [\n \"1111aaaa-2222-3333-4444-5555bbbbcccc\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"antigen_ids": [
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
],
"created_at": "2026-04-23T14:15:00+00:00",
"drug_class": "naked_antibody",
"format": "mab",
"format_metadata": {},
"id": "c0f5e4b1-a7d2-4e0b-9f8c-1b2d3e4f5a6b",
"initial_variant_id": "9999eeee-8888-dddd-7777-cccc66665555",
"name": "anti-HER2 mab",
"object": "therapeutic_candidate",
"project_id": "7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f",
"source_antibody_ids": [
"1111aaaa-2222-3333-4444-5555bbbbcccc"
],
"updated_at": "2026-04-23T14:15:00+00:00"
}{
"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"
}{
"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"
}{
"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"
}{
"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"
}{
"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"
}{
"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"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Body for POST /v1/therapeutic-candidates.
Mirrors :class:app.schemas.candidates.CandidateCreate but annotated
for the /v1 OpenAPI surface. initial_chains is required — the
service auto-creates the baseline variant (v1) and its chains
atomically; failures roll the candidate row back, so the DB never
ends up with a candidate missing its baseline.
Project the candidate belongs to. Must be owned by the caller's org.
Example:
"7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f"
Short human label (e.g. anti-HER2 mab).
Required string length:
1 - 120Example:
"anti-HER2 mab"
Molecular format — see the envelope's format field.
Available options:
mab, nanobody, scfv, fc_fusion, bispecific_kih, bispecific_crossmab, bispecific_common_lc, bite, dart, dvd_ig, tandem_scfv, trispecific_tandem_scfv, trispecific_igg_scfv, trispecific_knh_scfv Chain specs used to build the baseline variant (v1). At least one chain is required. References in the chain specs (source_antibody_id, constant_region_id) are scope-checked before insert; custom constant-region rows must belong to the caller's org, but the built-in library (org_id IS NULL) is always accessible.
Minimum array length:
1Show child attributes
Show child attributes
Therapeutic modality. Defaults to naked_antibody.
Available options:
naked_antibody, adc, car, radioconjugate, t_cell_engager Format-specific metadata (bispecific arm assignments, etc.).
Optional freeform note.
IDs of parental antibodies to link at create time. Every id must walk back to the caller's org; cross-org ids return 404.
IDs of antigens this candidate targets. Cross-org ids return 404.
Response
Successful Response
A therapeutic candidate as returned by /v1.
Carries the junction-table IDs (source antibodies, antigens) and the
initial_variant_id surfaced by create_candidate so a caller
can submit pipelines against it without a second round-trip.
Opaque therapeutic-candidate identifier (UUID).
Example:
"c0f5e4b1-a7d2-4e0b-9f8c-1b2d3e4f5a6b"
Project this candidate belongs to.
Example:
"7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f"
Short human label shown in dashboards and logs.
Molecular format. Single-arm (mab, nanobody, scfv, fc_fusion) require one H+L pair or a single-chain spec. Multi-arm formats require all arms' chain specs at create time.
Available options:
mab, nanobody, scfv, fc_fusion, bispecific_kih, bispecific_crossmab, bispecific_common_lc, bite, dart, dvd_ig, tandem_scfv, trispecific_tandem_scfv, trispecific_igg_scfv, trispecific_knh_scfv Therapeutic modality. naked_antibody is the default; adc and radioconjugate require a subsequent ADC-design record before payload synthesis.
Available options:
naked_antibody, adc, car, radioconjugate, t_cell_engager ISO-8601 timestamp (UTC) when the candidate was registered.
ISO-8601 timestamp (UTC) of the most recent mutation.
Polymorphic discriminator. Always therapeutic_candidate.
Allowed value:
"therapeutic_candidate"Free-form metadata bag — the bispecific formats use this for arm assignments; other formats leave it empty.
Optional freeform note shown alongside the candidate.
Source (parental) antibodies linked to this candidate. Maintained via the /v1/therapeutic-candidates/{id}/source-antibodies/{sa_id} endpoints.
Antigens this candidate targets. Maintained via the /v1/therapeutic-candidates/{id}/antigens/{antigen_id} endpoints.
The baseline variant (v1) auto-created alongside this candidate. Populated on create responses; null on read responses — to walk variants post-creation, list them via the variants resource (not yet exposed in /v1, Phase 3 follow-up).