Skip to main content
POST
/
v1
/
source-antibodies
Register a source antibody
curl --request POST \
  --url https://api.example.com/v1/source-antibodies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "molecule_type": "mab",
  "name": "Adalimumab",
  "project_id": "7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f",
  "species_origin": "mouse",
  "vh_sequence": "QVQLVESGGGLVQPGGSLRLSCAASGFTFSDYAMSWVRQAPGKGLEWVSAITWSGGSTYYADSVKGRFTISRDNSKNTLYLQMNSLRAEDTAVYYCAKDRGTTMVPFDYWGQGTLVTVSS",
  "vl_sequence": "DIQMTQSPSSLSASVGDRVTITCRASQGIRNYLAWYQQKPGKAPKRLIYAASTLQSGVPSRFSGSGSGTDFTLTISSLQPEDVATYYCQRYNRAPYTFGQGTKVEIK"
}
'
{
  "created_at": "2026-04-21T14:05:00+00:00",
  "id": "a1b2c3d4-e5f6-4789-89ab-cdef01234567",
  "molecule_type": "mab",
  "name": "Adalimumab",
  "project_id": "7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f",
  "species_origin": "mouse",
  "vh_sequence": "QVQLVESGGGLVQPGGSLRLSCAASGFTFSDYAMSWVRQAPGKGLEWVSAITWSGGSTYYADSVKGRFTISRDNSKNTLYLQMNSLRAEDTAVYYCAKDRGTTMVPFDYWGQGTLVTVSS",
  "vl_sequence": "DIQMTQSPSSLSASVGDRVTITCRASQGIRNYLAWYQQKPGKAPKRLIYAASTLQSGVPSRFSGSGSGTDFTLTISSLQPEDVATYYCQRYNRAPYTFGQGTKVEIK"
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Body for POST /v1/source-antibodies.

​
project_id
string
required

UUID of the project to register this antibody under. Must belong to the caller's org.

Example:

"7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f"

​
name
string
required

Display name (1–120 chars).

Required string length: 1 - 120
Example:

"Adalimumab"

​
species_origin
string
required

One of: mouse, rabbit, llama, human, synthetic, other.

Example:

"mouse"

​
vh_sequence
string
required

Heavy-chain variable region amino-acid sequence (single-letter code).

Example:

"QVQLVESGGGLVQPGGSLRLSCAASGFTFS..."

​
molecule_type
string
default:mab

mab (paired VH+VL) or nanobody (single-domain VHH). Nanobodies must omit vl_sequence; mAbs require it.

Example:

"mab"

​
vl_sequence
string | null

Light-chain variable region. Required for mab; must be null for nanobody.

Example:

"DIQMTQSPSSLSASVGDRVTITCRASQGIRN..."

Response

Successful Response

A source (parental) antibody sequence registered under a project.

​
id
string
required

Opaque source antibody identifier (UUID).

Example:

"a1b2c3d4-e5f6-4789-89ab-cdef01234567"

​
name
string
required

Display name.

Example:

"Adalimumab"

​
species_origin
string
required

One of: mouse, rabbit, llama, human, synthetic, other.

Example:

"mouse"

​
molecule_type
string
required

Either mab (paired VH+VL) or nanobody (single-domain VHH).

Example:

"mab"

​
vh_sequence
string
required

Heavy-chain variable region amino-acid sequence.

Example:

"QVQLVESGGGLVQPGGSLRLSCAASGFTFS..."

​
project_id
string
required

Parent project this antibody is registered under.

Example:

"7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f"

​
created_at
string
required

ISO-8601 timestamp (UTC) when the record was created.

Example:

"2026-04-21T14:05:00+00:00"

​
vl_sequence
string | null

Light-chain variable region amino-acid sequence. null for nanobodies.

Example:

"DIQMTQSPSSLSASVGDRVTITCRASQGIRN..."