Delete a therapeutic candidate

curl --request DELETE \
  --url https://api.example.com/v1/therapeutic-candidates/{candidate_id} \
  --header 'Authorization: Bearer <token>'

{
  "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

Delete a therapeutic candidate

Delete a therapeutic candidate.

Cascade. variants.candidate_id is ON DELETE CASCADE, and variant_chains / jobs / pipeline result tables cascade from there — so deleting a candidate drops the full tree underneath it: every variant, every chain row, every submitted pipeline job, and every emitted result. The junction rows in candidate_source_antibodies and candidate_antigens also cascade; the linked source antibodies and antigens themselves stay because they’re scoped to the project, not the candidate.

Callers that want to keep pipeline history should archive the candidate at the application layer (rename, tag, stop submitting against it) rather than deleting.

Cost: write — burns rate + quota. Does not debit credits.

DELETE

therapeutic-candidates

{candidate_id}

Delete a therapeutic candidate

curl --request DELETE \
  --url https://api.example.com/v1/therapeutic-candidates/{candidate_id} \
  --header 'Authorization: Bearer <token>'

{
  "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

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

candidate_id

string<uuid>

required

Response

Successful Response

Fetch a therapeutic candidate Update a therapeutic candidate

⌘I

Getting started

Guides

API Reference

Delete a therapeutic candidate

Authorizations

Path Parameters

Response