Update proposal template
curl --request PATCH \
--url https://api.vollna.com/v1/proposal-templates/{id} \
--header 'Content-Type: application/json' \
--header 'X-API-TOKEN: <api-key>' \
--data '
{
"name": "Web development",
"hourly_rate": {
"rate": 501,
"smart_rate_min": 501,
"smart_rate_max": 501,
"smart_rate_percent": 50,
"increase_percent": 1,
"rules": [
{
"from": 1,
"value": 123,
"to": 123
}
]
},
"fixed_price": {
"price": 500002.5,
"min_price": 500002.5,
"client_budget_percent": 500
},
"ai": {
"model": "gemini-3.6-flash",
"instructions": "Write like a human",
"client_questions": "<string>",
"additional_context": "<string>",
"template_structure": true
},
"ab_testing": true,
"answers": [
{
"question": "Availability?",
"answer": "Full time"
}
],
"cover_letters": {
"variant_a": "<string>",
"variant_b": "<string>"
}
}
'import requests
url = "https://api.vollna.com/v1/proposal-templates/{id}"
payload = {
"name": "Web development",
"hourly_rate": {
"rate": 501,
"smart_rate_min": 501,
"smart_rate_max": 501,
"smart_rate_percent": 50,
"increase_percent": 1,
"rules": [
{
"from": 1,
"value": 123,
"to": 123
}
]
},
"fixed_price": {
"price": 500002.5,
"min_price": 500002.5,
"client_budget_percent": 500
},
"ai": {
"model": "gemini-3.6-flash",
"instructions": "Write like a human",
"client_questions": "<string>",
"additional_context": "<string>",
"template_structure": True
},
"ab_testing": True,
"answers": [
{
"question": "Availability?",
"answer": "Full time"
}
],
"cover_letters": {
"variant_a": "<string>",
"variant_b": "<string>"
}
}
headers = {
"X-API-TOKEN": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'X-API-TOKEN': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Web development',
hourly_rate: {
rate: 501,
smart_rate_min: 501,
smart_rate_max: 501,
smart_rate_percent: 50,
increase_percent: 1,
rules: [{from: 1, value: 123, to: 123}]
},
fixed_price: {price: 500002.5, min_price: 500002.5, client_budget_percent: 500},
ai: {
model: 'gemini-3.6-flash',
instructions: 'Write like a human',
client_questions: '<string>',
additional_context: '<string>',
template_structure: true
},
ab_testing: true,
answers: [{question: 'Availability?', answer: 'Full time'}],
cover_letters: {variant_a: '<string>', variant_b: '<string>'}
})
};
fetch('https://api.vollna.com/v1/proposal-templates/{id}', 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.vollna.com/v1/proposal-templates/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Web development',
'hourly_rate' => [
'rate' => 501,
'smart_rate_min' => 501,
'smart_rate_max' => 501,
'smart_rate_percent' => 50,
'increase_percent' => 1,
'rules' => [
[
'from' => 1,
'value' => 123,
'to' => 123
]
]
],
'fixed_price' => [
'price' => 500002.5,
'min_price' => 500002.5,
'client_budget_percent' => 500
],
'ai' => [
'model' => 'gemini-3.6-flash',
'instructions' => 'Write like a human',
'client_questions' => '<string>',
'additional_context' => '<string>',
'template_structure' => true
],
'ab_testing' => true,
'answers' => [
[
'question' => 'Availability?',
'answer' => 'Full time'
]
],
'cover_letters' => [
'variant_a' => '<string>',
'variant_b' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-TOKEN: <api-key>"
],
]);
$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.vollna.com/v1/proposal-templates/{id}"
payload := strings.NewReader("{\n \"name\": \"Web development\",\n \"hourly_rate\": {\n \"rate\": 501,\n \"smart_rate_min\": 501,\n \"smart_rate_max\": 501,\n \"smart_rate_percent\": 50,\n \"increase_percent\": 1,\n \"rules\": [\n {\n \"from\": 1,\n \"value\": 123,\n \"to\": 123\n }\n ]\n },\n \"fixed_price\": {\n \"price\": 500002.5,\n \"min_price\": 500002.5,\n \"client_budget_percent\": 500\n },\n \"ai\": {\n \"model\": \"gemini-3.6-flash\",\n \"instructions\": \"Write like a human\",\n \"client_questions\": \"<string>\",\n \"additional_context\": \"<string>\",\n \"template_structure\": true\n },\n \"ab_testing\": true,\n \"answers\": [\n {\n \"question\": \"Availability?\",\n \"answer\": \"Full time\"\n }\n ],\n \"cover_letters\": {\n \"variant_a\": \"<string>\",\n \"variant_b\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("X-API-TOKEN", "<api-key>")
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.patch("https://api.vollna.com/v1/proposal-templates/{id}")
.header("X-API-TOKEN", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Web development\",\n \"hourly_rate\": {\n \"rate\": 501,\n \"smart_rate_min\": 501,\n \"smart_rate_max\": 501,\n \"smart_rate_percent\": 50,\n \"increase_percent\": 1,\n \"rules\": [\n {\n \"from\": 1,\n \"value\": 123,\n \"to\": 123\n }\n ]\n },\n \"fixed_price\": {\n \"price\": 500002.5,\n \"min_price\": 500002.5,\n \"client_budget_percent\": 500\n },\n \"ai\": {\n \"model\": \"gemini-3.6-flash\",\n \"instructions\": \"Write like a human\",\n \"client_questions\": \"<string>\",\n \"additional_context\": \"<string>\",\n \"template_structure\": true\n },\n \"ab_testing\": true,\n \"answers\": [\n {\n \"question\": \"Availability?\",\n \"answer\": \"Full time\"\n }\n ],\n \"cover_letters\": {\n \"variant_a\": \"<string>\",\n \"variant_b\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vollna.com/v1/proposal-templates/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-API-TOKEN"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Web development\",\n \"hourly_rate\": {\n \"rate\": 501,\n \"smart_rate_min\": 501,\n \"smart_rate_max\": 501,\n \"smart_rate_percent\": 50,\n \"increase_percent\": 1,\n \"rules\": [\n {\n \"from\": 1,\n \"value\": 123,\n \"to\": 123\n }\n ]\n },\n \"fixed_price\": {\n \"price\": 500002.5,\n \"min_price\": 500002.5,\n \"client_budget_percent\": 500\n },\n \"ai\": {\n \"model\": \"gemini-3.6-flash\",\n \"instructions\": \"Write like a human\",\n \"client_questions\": \"<string>\",\n \"additional_context\": \"<string>\",\n \"template_structure\": true\n },\n \"ab_testing\": true,\n \"answers\": [\n {\n \"question\": \"Availability?\",\n \"answer\": \"Full time\"\n }\n ],\n \"cover_letters\": {\n \"variant_a\": \"<string>\",\n \"variant_b\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": 123,
"name": "Web development",
"visibility": "shared_admins",
"sender": {
"name": "John Smith",
"type": "agency",
"organization": "Acme Agency LLC"
},
"hourly_rate": {
"mode": "smart",
"rate": 50,
"smart_rate_min": 25,
"smart_rate_max": 120,
"smart_rate_percent": 98,
"rules_count": 0,
"increase_percent": null,
"increase_frequency": "never",
"rules": [
{
"from": 1,
"rate_type": "fixed",
"value": 123,
"to": 123
}
]
},
"fixed_price": {
"type": "by-job-terms",
"price": 123,
"min_price": 123,
"client_budget_percent": 123
},
"ai": {
"model": "gemini-3.6-flash",
"instructions": "Write like a human",
"client_questions": "Answer briefly",
"additional_context": "<string>",
"template_structure": true
},
"filters": [
{
"id": 123,
"name": "<string>"
}
],
"auto_bidding_setups": [
{
"id": 123,
"name": "<string>"
}
],
"ab_testing": true,
"answers": [
{
"question": "Availability?",
"answer": "Full time",
"match_type": "exact"
}
],
"attachments": [
{
"uid": "9f1c2ab34de56f7890ab12cd34ef56ab",
"name": "portfolio.pdf",
"mime_type": "application/pdf",
"size_bytes": 245760
}
],
"cover_letters": {
"variant_a": "Hi, I build web apps with Symfony and React...",
"variant_b": "<string>"
},
"created_at": "2026-08-26T10:00:00+00:00",
"updated_at": "2026-08-26T10:00:00+00:00"
}
}{
"error": "Validation failed",
"fields": {
"hourly_rate.rate": "must be a number between 3 and 999",
"ai.model": "unknown model"
}
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "Validation failed",
"message": "<string>",
"fields": {}
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}Proposal Templates
Update proposal template
Partial update (JSON Merge Patch): only the fields present in the body are applied, null clears or disables a field. Unknown and read-only fields are rejected. Validation runs fully before anything is written, so a failed request changes nothing
PATCH
/
proposal-templates
/
{id}
Update proposal template
curl --request PATCH \
--url https://api.vollna.com/v1/proposal-templates/{id} \
--header 'Content-Type: application/json' \
--header 'X-API-TOKEN: <api-key>' \
--data '
{
"name": "Web development",
"hourly_rate": {
"rate": 501,
"smart_rate_min": 501,
"smart_rate_max": 501,
"smart_rate_percent": 50,
"increase_percent": 1,
"rules": [
{
"from": 1,
"value": 123,
"to": 123
}
]
},
"fixed_price": {
"price": 500002.5,
"min_price": 500002.5,
"client_budget_percent": 500
},
"ai": {
"model": "gemini-3.6-flash",
"instructions": "Write like a human",
"client_questions": "<string>",
"additional_context": "<string>",
"template_structure": true
},
"ab_testing": true,
"answers": [
{
"question": "Availability?",
"answer": "Full time"
}
],
"cover_letters": {
"variant_a": "<string>",
"variant_b": "<string>"
}
}
'import requests
url = "https://api.vollna.com/v1/proposal-templates/{id}"
payload = {
"name": "Web development",
"hourly_rate": {
"rate": 501,
"smart_rate_min": 501,
"smart_rate_max": 501,
"smart_rate_percent": 50,
"increase_percent": 1,
"rules": [
{
"from": 1,
"value": 123,
"to": 123
}
]
},
"fixed_price": {
"price": 500002.5,
"min_price": 500002.5,
"client_budget_percent": 500
},
"ai": {
"model": "gemini-3.6-flash",
"instructions": "Write like a human",
"client_questions": "<string>",
"additional_context": "<string>",
"template_structure": True
},
"ab_testing": True,
"answers": [
{
"question": "Availability?",
"answer": "Full time"
}
],
"cover_letters": {
"variant_a": "<string>",
"variant_b": "<string>"
}
}
headers = {
"X-API-TOKEN": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'X-API-TOKEN': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Web development',
hourly_rate: {
rate: 501,
smart_rate_min: 501,
smart_rate_max: 501,
smart_rate_percent: 50,
increase_percent: 1,
rules: [{from: 1, value: 123, to: 123}]
},
fixed_price: {price: 500002.5, min_price: 500002.5, client_budget_percent: 500},
ai: {
model: 'gemini-3.6-flash',
instructions: 'Write like a human',
client_questions: '<string>',
additional_context: '<string>',
template_structure: true
},
ab_testing: true,
answers: [{question: 'Availability?', answer: 'Full time'}],
cover_letters: {variant_a: '<string>', variant_b: '<string>'}
})
};
fetch('https://api.vollna.com/v1/proposal-templates/{id}', 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.vollna.com/v1/proposal-templates/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Web development',
'hourly_rate' => [
'rate' => 501,
'smart_rate_min' => 501,
'smart_rate_max' => 501,
'smart_rate_percent' => 50,
'increase_percent' => 1,
'rules' => [
[
'from' => 1,
'value' => 123,
'to' => 123
]
]
],
'fixed_price' => [
'price' => 500002.5,
'min_price' => 500002.5,
'client_budget_percent' => 500
],
'ai' => [
'model' => 'gemini-3.6-flash',
'instructions' => 'Write like a human',
'client_questions' => '<string>',
'additional_context' => '<string>',
'template_structure' => true
],
'ab_testing' => true,
'answers' => [
[
'question' => 'Availability?',
'answer' => 'Full time'
]
],
'cover_letters' => [
'variant_a' => '<string>',
'variant_b' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-TOKEN: <api-key>"
],
]);
$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.vollna.com/v1/proposal-templates/{id}"
payload := strings.NewReader("{\n \"name\": \"Web development\",\n \"hourly_rate\": {\n \"rate\": 501,\n \"smart_rate_min\": 501,\n \"smart_rate_max\": 501,\n \"smart_rate_percent\": 50,\n \"increase_percent\": 1,\n \"rules\": [\n {\n \"from\": 1,\n \"value\": 123,\n \"to\": 123\n }\n ]\n },\n \"fixed_price\": {\n \"price\": 500002.5,\n \"min_price\": 500002.5,\n \"client_budget_percent\": 500\n },\n \"ai\": {\n \"model\": \"gemini-3.6-flash\",\n \"instructions\": \"Write like a human\",\n \"client_questions\": \"<string>\",\n \"additional_context\": \"<string>\",\n \"template_structure\": true\n },\n \"ab_testing\": true,\n \"answers\": [\n {\n \"question\": \"Availability?\",\n \"answer\": \"Full time\"\n }\n ],\n \"cover_letters\": {\n \"variant_a\": \"<string>\",\n \"variant_b\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("X-API-TOKEN", "<api-key>")
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.patch("https://api.vollna.com/v1/proposal-templates/{id}")
.header("X-API-TOKEN", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Web development\",\n \"hourly_rate\": {\n \"rate\": 501,\n \"smart_rate_min\": 501,\n \"smart_rate_max\": 501,\n \"smart_rate_percent\": 50,\n \"increase_percent\": 1,\n \"rules\": [\n {\n \"from\": 1,\n \"value\": 123,\n \"to\": 123\n }\n ]\n },\n \"fixed_price\": {\n \"price\": 500002.5,\n \"min_price\": 500002.5,\n \"client_budget_percent\": 500\n },\n \"ai\": {\n \"model\": \"gemini-3.6-flash\",\n \"instructions\": \"Write like a human\",\n \"client_questions\": \"<string>\",\n \"additional_context\": \"<string>\",\n \"template_structure\": true\n },\n \"ab_testing\": true,\n \"answers\": [\n {\n \"question\": \"Availability?\",\n \"answer\": \"Full time\"\n }\n ],\n \"cover_letters\": {\n \"variant_a\": \"<string>\",\n \"variant_b\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vollna.com/v1/proposal-templates/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-API-TOKEN"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Web development\",\n \"hourly_rate\": {\n \"rate\": 501,\n \"smart_rate_min\": 501,\n \"smart_rate_max\": 501,\n \"smart_rate_percent\": 50,\n \"increase_percent\": 1,\n \"rules\": [\n {\n \"from\": 1,\n \"value\": 123,\n \"to\": 123\n }\n ]\n },\n \"fixed_price\": {\n \"price\": 500002.5,\n \"min_price\": 500002.5,\n \"client_budget_percent\": 500\n },\n \"ai\": {\n \"model\": \"gemini-3.6-flash\",\n \"instructions\": \"Write like a human\",\n \"client_questions\": \"<string>\",\n \"additional_context\": \"<string>\",\n \"template_structure\": true\n },\n \"ab_testing\": true,\n \"answers\": [\n {\n \"question\": \"Availability?\",\n \"answer\": \"Full time\"\n }\n ],\n \"cover_letters\": {\n \"variant_a\": \"<string>\",\n \"variant_b\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": 123,
"name": "Web development",
"visibility": "shared_admins",
"sender": {
"name": "John Smith",
"type": "agency",
"organization": "Acme Agency LLC"
},
"hourly_rate": {
"mode": "smart",
"rate": 50,
"smart_rate_min": 25,
"smart_rate_max": 120,
"smart_rate_percent": 98,
"rules_count": 0,
"increase_percent": null,
"increase_frequency": "never",
"rules": [
{
"from": 1,
"rate_type": "fixed",
"value": 123,
"to": 123
}
]
},
"fixed_price": {
"type": "by-job-terms",
"price": 123,
"min_price": 123,
"client_budget_percent": 123
},
"ai": {
"model": "gemini-3.6-flash",
"instructions": "Write like a human",
"client_questions": "Answer briefly",
"additional_context": "<string>",
"template_structure": true
},
"filters": [
{
"id": 123,
"name": "<string>"
}
],
"auto_bidding_setups": [
{
"id": 123,
"name": "<string>"
}
],
"ab_testing": true,
"answers": [
{
"question": "Availability?",
"answer": "Full time",
"match_type": "exact"
}
],
"attachments": [
{
"uid": "9f1c2ab34de56f7890ab12cd34ef56ab",
"name": "portfolio.pdf",
"mime_type": "application/pdf",
"size_bytes": 245760
}
],
"cover_letters": {
"variant_a": "Hi, I build web apps with Symfony and React...",
"variant_b": "<string>"
},
"created_at": "2026-08-26T10:00:00+00:00",
"updated_at": "2026-08-26T10:00:00+00:00"
}
}{
"error": "Validation failed",
"fields": {
"hourly_rate.rate": "must be a number between 3 and 999",
"ai.model": "unknown model"
}
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "Validation failed",
"message": "<string>",
"fields": {}
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}Body
application/json
All fields optional; send only what you change. null clears or disables where noted
Was this page helpful?