POST/cloning/gibson/primersGibson assembly primers (overlap + annealing)
gibson_cloning_primers
Description
Designs forward/reverse primers for an insert: overlap regions are taken from `start_overlap_seq` / `end_overlap_seq` templates (extended until overlap Tm target), combined with annealing regions designed to `primer_tm`.
Options: All three fields are required (`primer_tm`, `overlap_size`, `overlap_tm`). `overlap_size` is a minimum overlap length in bp (integer ≥ 1).
Request body
{
"content": {
"application/json": {
"schema": {
"properties": {
"end_overlap_seq": {
"allOf": [
{
"$ref": "#/paths/~1backbone~1linearize~1restriction/post/responses/200/content/application~1json/schema/properties/results/properties/seq"
}
],
"description": "Template for the 3' overlap."
},
"options": {
"properties": {
"overlap_size": {
"description": "Minimum overlap length (bp); actual overlap may grow to meet `overlap_tm`.",
"example": 25,
"minimum": 1,
"type": "integer"
},
"overlap_tm": {
"description": "Target duplex Tm (°C) applied when lengthening homology tails: overlap size grows until a sliding nearest-neighbour estimate reaches this target with simpler ion modelling than the primer melting_temperature fields (those use the fuller mixed-ion recipe on the insert annealing segment only—not the overlap).\n",
"type": "integer"
},
"primer_tm": {
"description": "Target Tm (°C) for the annealing portion of the primer.",
"type": "integer"
}
},
"required": [
"primer_tm",
"overlap_size",
"overlap_tm"
],
"type": "object"
},
"seq": {
"allOf": [
{
"$ref": "#/paths/~1backbone~1linearize~1restriction/post/responses/200/content/application~1json/schema/properties/results/properties/seq"
}
],
"description": "Linear insert sequence to amplify for Gibson assembly."
},
"start_overlap_seq": {
"allOf": [
{
"$ref": "#/paths/~1backbone~1linearize~1restriction/post/responses/200/content/application~1json/schema/properties/results/properties/seq"
}
],
"description": "Template for the 5' overlap (typically vector-adjacent homology); longer than final overlap."
}
},
"required": [
"seq",
"start_overlap_seq",
"end_overlap_seq",
"options"
],
"type": "object"
}
}
}
}Responses
{
"200": {
"content": {
"application/json": {
"schema": {
"properties": {
"results": {
"properties": {
"forward": {
"description": "One Gibson assembly primer: overlap (homology) region plus annealing region, full primer sequence, Tm of the annealing part, and ΔG metrics for the full primer (hairpin and homodimer components plus their minimum).\n",
"properties": {
"annealing_sequence": {
"allOf": [
{
"$ref": "#/paths/~1backbone~1linearize~1restriction/post/responses/200/content/application~1json/schema/properties/results/properties/seq"
}
],
"description": "Insert-specific annealing region (designed to target Tm)."
},
"full_seq": {
"$ref": "#/paths/~1backbone~1linearize~1restriction/post/responses/200/content/application~1json/schema/properties/results/properties/seq"
},
"gibbs_free_energy": {
"allOf": [
{
"$ref": "#/paths/~1primers~1simple/post/responses/200/content/application~1json/schema/properties/results/properties/forward/properties/gibbs_free_energy"
}
],
"description": "Minimum of hairpin and homodimer ΔG for the full primer (kcal/mol)."
},
"hairpin_gibbs_free_energy": {
"$ref": "#/paths/~1primers~1simple/post/responses/200/content/application~1json/schema/properties/results/properties/forward/properties/hairpin_gibbs_free_energy"
},
"homodimer_gibbs_free_energy": {
"$ref": "#/paths/~1primers~1simple/post/responses/200/content/application~1json/schema/properties/results/properties/forward/properties/homodimer_gibbs_free_energy"
},
"melting_temperature": {
"$ref": "#/paths/~1primers~1simple/post/responses/200/content/application~1json/schema/properties/results/properties/forward/properties/melting_temperature"
},
"overlap": {
"allOf": [
{
"$ref": "#/paths/~1backbone~1linearize~1restriction/post/responses/200/content/application~1json/schema/properties/results/properties/seq"
}
],
"description": "Homology overhang taken from the provided overlap template."
}
},
"required": [
"annealing_sequence",
"overlap",
"full_seq",
"melting_temperature",
"hairpin_gibbs_free_energy",
"homodimer_gibbs_free_energy",
"gibbs_free_energy"
],
"type": "object"
},
"reverse": {
"$ref": "#/paths/~1cloning~1gibson~1primers/post/responses/200/content/application~1json/schema/properties/results/properties/forward"
}
},
"required": [
"forward",
"reverse"
],
"type": "object"
},
"status": {
"enum": [
"success"
],
"type": "string"
}
},
"required": [
"status",
"results"
],
"type": "object"
}
}
},
"description": "Forward and reverse Gibson primers (full sequences include overlaps)."
},
"400": {
"$ref": "#/paths/~1backbone~1linearize~1selection/post/responses/400"
},
"422": {
"$ref": "#/paths/~1backbone~1linearize~1selection/post/responses/400"
}
}