Update a subscription recast
curl --request PATCH \
--url https://api.salesbricks.com/api/v2/subscriptions/{subscription_id}/recast/{order_id} \
--header 'Content-Type: application/json' \
--header 'X-SALESBRICKS-KEY: <api-key>' \
--data '
{
"contract_length": 2,
"plan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"bricks": [
{
"brick_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": 123,
"discount": [
{
"rate": "<string>",
"amount": 123,
"renews": false
}
]
}
],
"discount_coupons": [
"<string>"
],
"phases": [
{
"phase_position": 1,
"bricks": [
{
"brick_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": 123,
"discount": [
{
"rate": "<string>",
"amount": 123,
"renews": false
}
]
}
],
"starts_at": "2023-12-25",
"contract_length": 2,
"plan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"payment_terms": 499,
"discount_coupons": [
"<string>"
]
}
],
"point_of_contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"signatory_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"auto_renews": true,
"accounts_payable_emails": [
"jsmith@example.com"
],
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"payment_terms": 499,
"renewal_contract_period": 2,
"renewal_uplifted_rate": "<string>",
"metadata": "<unknown>",
"custom_order_form_html": "<string>",
"accepted_payment_methods_config": {
"paywall_credit_card": true,
"paywall_check": true,
"paywall_ach": true,
"paywall_wire": true,
"checkout_credit_card": true,
"checkout_ach": true,
"checkout_order_form": true,
"minimum_order_form_tcv": 0,
"paywall_force_autopay": false
},
"purchase_order": {
"code": "<string>"
},
"legal_entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"adjustment_credit": 123,
"adjustment_credit_label": "<string>"
}
'import requests
url = "https://api.salesbricks.com/api/v2/subscriptions/{subscription_id}/recast/{order_id}"
payload = {
"contract_length": 2,
"plan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"bricks": [
{
"brick_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": 123,
"discount": [
{
"rate": "<string>",
"amount": 123,
"renews": False
}
]
}
],
"discount_coupons": ["<string>"],
"phases": [
{
"phase_position": 1,
"bricks": [
{
"brick_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": 123,
"discount": [
{
"rate": "<string>",
"amount": 123,
"renews": False
}
]
}
],
"starts_at": "2023-12-25",
"contract_length": 2,
"plan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"payment_terms": 499,
"discount_coupons": ["<string>"]
}
],
"point_of_contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"signatory_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"auto_renews": True,
"accounts_payable_emails": ["jsmith@example.com"],
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"payment_terms": 499,
"renewal_contract_period": 2,
"renewal_uplifted_rate": "<string>",
"metadata": "<unknown>",
"custom_order_form_html": "<string>",
"accepted_payment_methods_config": {
"paywall_credit_card": True,
"paywall_check": True,
"paywall_ach": True,
"paywall_wire": True,
"checkout_credit_card": True,
"checkout_ach": True,
"checkout_order_form": True,
"minimum_order_form_tcv": 0,
"paywall_force_autopay": False
},
"purchase_order": { "code": "<string>" },
"legal_entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"adjustment_credit": 123,
"adjustment_credit_label": "<string>"
}
headers = {
"X-SALESBRICKS-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'X-SALESBRICKS-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
contract_length: 2,
plan_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
bricks: [
{
brick_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
quantity: 123,
discount: [{rate: '<string>', amount: 123, renews: false}]
}
],
discount_coupons: ['<string>'],
phases: [
{
phase_position: 1,
bricks: [
{
brick_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
quantity: 123,
discount: [{rate: '<string>', amount: 123, renews: false}]
}
],
starts_at: '2023-12-25',
contract_length: 2,
plan_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
payment_terms: 499,
discount_coupons: ['<string>']
}
],
point_of_contact_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
signatory_user_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
auto_renews: true,
accounts_payable_emails: ['jsmith@example.com'],
customer_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
payment_terms: 499,
renewal_contract_period: 2,
renewal_uplifted_rate: '<string>',
metadata: '<unknown>',
custom_order_form_html: '<string>',
accepted_payment_methods_config: {
paywall_credit_card: true,
paywall_check: true,
paywall_ach: true,
paywall_wire: true,
checkout_credit_card: true,
checkout_ach: true,
checkout_order_form: true,
minimum_order_form_tcv: 0,
paywall_force_autopay: false
},
purchase_order: {code: '<string>'},
legal_entity_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
adjustment_credit: 123,
adjustment_credit_label: '<string>'
})
};
fetch('https://api.salesbricks.com/api/v2/subscriptions/{subscription_id}/recast/{order_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.salesbricks.com/api/v2/subscriptions/{subscription_id}/recast/{order_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([
'contract_length' => 2,
'plan_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'bricks' => [
[
'brick_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'quantity' => 123,
'discount' => [
[
'rate' => '<string>',
'amount' => 123,
'renews' => false
]
]
]
],
'discount_coupons' => [
'<string>'
],
'phases' => [
[
'phase_position' => 1,
'bricks' => [
[
'brick_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'quantity' => 123,
'discount' => [
[
'rate' => '<string>',
'amount' => 123,
'renews' => false
]
]
]
],
'starts_at' => '2023-12-25',
'contract_length' => 2,
'plan_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'payment_terms' => 499,
'discount_coupons' => [
'<string>'
]
]
],
'point_of_contact_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'signatory_user_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'auto_renews' => true,
'accounts_payable_emails' => [
'jsmith@example.com'
],
'customer_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'payment_terms' => 499,
'renewal_contract_period' => 2,
'renewal_uplifted_rate' => '<string>',
'metadata' => '<unknown>',
'custom_order_form_html' => '<string>',
'accepted_payment_methods_config' => [
'paywall_credit_card' => true,
'paywall_check' => true,
'paywall_ach' => true,
'paywall_wire' => true,
'checkout_credit_card' => true,
'checkout_ach' => true,
'checkout_order_form' => true,
'minimum_order_form_tcv' => 0,
'paywall_force_autopay' => false
],
'purchase_order' => [
'code' => '<string>'
],
'legal_entity_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'adjustment_credit' => 123,
'adjustment_credit_label' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-SALESBRICKS-KEY: <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.salesbricks.com/api/v2/subscriptions/{subscription_id}/recast/{order_id}"
payload := strings.NewReader("{\n \"contract_length\": 2,\n \"plan_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"bricks\": [\n {\n \"brick_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"quantity\": 123,\n \"discount\": [\n {\n \"rate\": \"<string>\",\n \"amount\": 123,\n \"renews\": false\n }\n ]\n }\n ],\n \"discount_coupons\": [\n \"<string>\"\n ],\n \"phases\": [\n {\n \"phase_position\": 1,\n \"bricks\": [\n {\n \"brick_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"quantity\": 123,\n \"discount\": [\n {\n \"rate\": \"<string>\",\n \"amount\": 123,\n \"renews\": false\n }\n ]\n }\n ],\n \"starts_at\": \"2023-12-25\",\n \"contract_length\": 2,\n \"plan_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"payment_terms\": 499,\n \"discount_coupons\": [\n \"<string>\"\n ]\n }\n ],\n \"point_of_contact_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"signatory_user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"auto_renews\": true,\n \"accounts_payable_emails\": [\n \"jsmith@example.com\"\n ],\n \"customer_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"payment_terms\": 499,\n \"renewal_contract_period\": 2,\n \"renewal_uplifted_rate\": \"<string>\",\n \"metadata\": \"<unknown>\",\n \"custom_order_form_html\": \"<string>\",\n \"accepted_payment_methods_config\": {\n \"paywall_credit_card\": true,\n \"paywall_check\": true,\n \"paywall_ach\": true,\n \"paywall_wire\": true,\n \"checkout_credit_card\": true,\n \"checkout_ach\": true,\n \"checkout_order_form\": true,\n \"minimum_order_form_tcv\": 0,\n \"paywall_force_autopay\": false\n },\n \"purchase_order\": {\n \"code\": \"<string>\"\n },\n \"legal_entity_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"adjustment_credit\": 123,\n \"adjustment_credit_label\": \"<string>\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("X-SALESBRICKS-KEY", "<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.salesbricks.com/api/v2/subscriptions/{subscription_id}/recast/{order_id}")
.header("X-SALESBRICKS-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"contract_length\": 2,\n \"plan_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"bricks\": [\n {\n \"brick_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"quantity\": 123,\n \"discount\": [\n {\n \"rate\": \"<string>\",\n \"amount\": 123,\n \"renews\": false\n }\n ]\n }\n ],\n \"discount_coupons\": [\n \"<string>\"\n ],\n \"phases\": [\n {\n \"phase_position\": 1,\n \"bricks\": [\n {\n \"brick_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"quantity\": 123,\n \"discount\": [\n {\n \"rate\": \"<string>\",\n \"amount\": 123,\n \"renews\": false\n }\n ]\n }\n ],\n \"starts_at\": \"2023-12-25\",\n \"contract_length\": 2,\n \"plan_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"payment_terms\": 499,\n \"discount_coupons\": [\n \"<string>\"\n ]\n }\n ],\n \"point_of_contact_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"signatory_user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"auto_renews\": true,\n \"accounts_payable_emails\": [\n \"jsmith@example.com\"\n ],\n \"customer_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"payment_terms\": 499,\n \"renewal_contract_period\": 2,\n \"renewal_uplifted_rate\": \"<string>\",\n \"metadata\": \"<unknown>\",\n \"custom_order_form_html\": \"<string>\",\n \"accepted_payment_methods_config\": {\n \"paywall_credit_card\": true,\n \"paywall_check\": true,\n \"paywall_ach\": true,\n \"paywall_wire\": true,\n \"checkout_credit_card\": true,\n \"checkout_ach\": true,\n \"checkout_order_form\": true,\n \"minimum_order_form_tcv\": 0,\n \"paywall_force_autopay\": false\n },\n \"purchase_order\": {\n \"code\": \"<string>\"\n },\n \"legal_entity_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"adjustment_credit\": 123,\n \"adjustment_credit_label\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.salesbricks.com/api/v2/subscriptions/{subscription_id}/recast/{order_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-SALESBRICKS-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"contract_length\": 2,\n \"plan_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"bricks\": [\n {\n \"brick_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"quantity\": 123,\n \"discount\": [\n {\n \"rate\": \"<string>\",\n \"amount\": 123,\n \"renews\": false\n }\n ]\n }\n ],\n \"discount_coupons\": [\n \"<string>\"\n ],\n \"phases\": [\n {\n \"phase_position\": 1,\n \"bricks\": [\n {\n \"brick_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"quantity\": 123,\n \"discount\": [\n {\n \"rate\": \"<string>\",\n \"amount\": 123,\n \"renews\": false\n }\n ]\n }\n ],\n \"starts_at\": \"2023-12-25\",\n \"contract_length\": 2,\n \"plan_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"payment_terms\": 499,\n \"discount_coupons\": [\n \"<string>\"\n ]\n }\n ],\n \"point_of_contact_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"signatory_user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"auto_renews\": true,\n \"accounts_payable_emails\": [\n \"jsmith@example.com\"\n ],\n \"customer_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"payment_terms\": 499,\n \"renewal_contract_period\": 2,\n \"renewal_uplifted_rate\": \"<string>\",\n \"metadata\": \"<unknown>\",\n \"custom_order_form_html\": \"<string>\",\n \"accepted_payment_methods_config\": {\n \"paywall_credit_card\": true,\n \"paywall_check\": true,\n \"paywall_ach\": true,\n \"paywall_wire\": true,\n \"checkout_credit_card\": true,\n \"checkout_ach\": true,\n \"checkout_order_form\": true,\n \"minimum_order_form_tcv\": 0,\n \"paywall_force_autopay\": false\n },\n \"purchase_order\": {\n \"code\": \"<string>\"\n },\n \"legal_entity_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"adjustment_credit\": 123,\n \"adjustment_credit_label\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"subscription_id": "<string>"
}{
"error": {
"code": "ERR_BAD_REQUEST",
"message": "Bad request — the input payload is malformed, missing required fields, or contains invalid data."
}
}{
"error": {
"code": "ERR_NOT_FOUND",
"message": "Not found — the resource you are looking for does not exist."
}
}Subscription Recasts
Update a subscription recast
Updates a subscription recast order. This endpoint allows you to modify bricks, AP contacts, and other properties for an existing recast order.
How bricks affects existing discounts:
Per-brick discounts are replaced, not merged. The discount sent on a brick becomes that brick’s complete set of discounts for this order, and a brick sent without a discount ends up with none — any discount it previously carried is dropped.
This applies to every brick in the payload, not only the ones being changed. A brick included solely to keep it on the order still needs its discount resent, or it loses it.
Read the current values from the subscription’s line items — discount is returned there in the same shape this endpoint accepts — and send them back for every brick whose discount should carry over.
PATCH
/
subscriptions
/
{subscription_id}
/
recast
/
{order_id}
Update a subscription recast
curl --request PATCH \
--url https://api.salesbricks.com/api/v2/subscriptions/{subscription_id}/recast/{order_id} \
--header 'Content-Type: application/json' \
--header 'X-SALESBRICKS-KEY: <api-key>' \
--data '
{
"contract_length": 2,
"plan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"bricks": [
{
"brick_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": 123,
"discount": [
{
"rate": "<string>",
"amount": 123,
"renews": false
}
]
}
],
"discount_coupons": [
"<string>"
],
"phases": [
{
"phase_position": 1,
"bricks": [
{
"brick_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": 123,
"discount": [
{
"rate": "<string>",
"amount": 123,
"renews": false
}
]
}
],
"starts_at": "2023-12-25",
"contract_length": 2,
"plan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"payment_terms": 499,
"discount_coupons": [
"<string>"
]
}
],
"point_of_contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"signatory_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"auto_renews": true,
"accounts_payable_emails": [
"jsmith@example.com"
],
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"payment_terms": 499,
"renewal_contract_period": 2,
"renewal_uplifted_rate": "<string>",
"metadata": "<unknown>",
"custom_order_form_html": "<string>",
"accepted_payment_methods_config": {
"paywall_credit_card": true,
"paywall_check": true,
"paywall_ach": true,
"paywall_wire": true,
"checkout_credit_card": true,
"checkout_ach": true,
"checkout_order_form": true,
"minimum_order_form_tcv": 0,
"paywall_force_autopay": false
},
"purchase_order": {
"code": "<string>"
},
"legal_entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"adjustment_credit": 123,
"adjustment_credit_label": "<string>"
}
'import requests
url = "https://api.salesbricks.com/api/v2/subscriptions/{subscription_id}/recast/{order_id}"
payload = {
"contract_length": 2,
"plan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"bricks": [
{
"brick_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": 123,
"discount": [
{
"rate": "<string>",
"amount": 123,
"renews": False
}
]
}
],
"discount_coupons": ["<string>"],
"phases": [
{
"phase_position": 1,
"bricks": [
{
"brick_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": 123,
"discount": [
{
"rate": "<string>",
"amount": 123,
"renews": False
}
]
}
],
"starts_at": "2023-12-25",
"contract_length": 2,
"plan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"payment_terms": 499,
"discount_coupons": ["<string>"]
}
],
"point_of_contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"signatory_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"auto_renews": True,
"accounts_payable_emails": ["jsmith@example.com"],
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"payment_terms": 499,
"renewal_contract_period": 2,
"renewal_uplifted_rate": "<string>",
"metadata": "<unknown>",
"custom_order_form_html": "<string>",
"accepted_payment_methods_config": {
"paywall_credit_card": True,
"paywall_check": True,
"paywall_ach": True,
"paywall_wire": True,
"checkout_credit_card": True,
"checkout_ach": True,
"checkout_order_form": True,
"minimum_order_form_tcv": 0,
"paywall_force_autopay": False
},
"purchase_order": { "code": "<string>" },
"legal_entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"adjustment_credit": 123,
"adjustment_credit_label": "<string>"
}
headers = {
"X-SALESBRICKS-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'X-SALESBRICKS-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
contract_length: 2,
plan_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
bricks: [
{
brick_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
quantity: 123,
discount: [{rate: '<string>', amount: 123, renews: false}]
}
],
discount_coupons: ['<string>'],
phases: [
{
phase_position: 1,
bricks: [
{
brick_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
quantity: 123,
discount: [{rate: '<string>', amount: 123, renews: false}]
}
],
starts_at: '2023-12-25',
contract_length: 2,
plan_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
payment_terms: 499,
discount_coupons: ['<string>']
}
],
point_of_contact_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
signatory_user_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
auto_renews: true,
accounts_payable_emails: ['jsmith@example.com'],
customer_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
payment_terms: 499,
renewal_contract_period: 2,
renewal_uplifted_rate: '<string>',
metadata: '<unknown>',
custom_order_form_html: '<string>',
accepted_payment_methods_config: {
paywall_credit_card: true,
paywall_check: true,
paywall_ach: true,
paywall_wire: true,
checkout_credit_card: true,
checkout_ach: true,
checkout_order_form: true,
minimum_order_form_tcv: 0,
paywall_force_autopay: false
},
purchase_order: {code: '<string>'},
legal_entity_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
adjustment_credit: 123,
adjustment_credit_label: '<string>'
})
};
fetch('https://api.salesbricks.com/api/v2/subscriptions/{subscription_id}/recast/{order_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.salesbricks.com/api/v2/subscriptions/{subscription_id}/recast/{order_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([
'contract_length' => 2,
'plan_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'bricks' => [
[
'brick_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'quantity' => 123,
'discount' => [
[
'rate' => '<string>',
'amount' => 123,
'renews' => false
]
]
]
],
'discount_coupons' => [
'<string>'
],
'phases' => [
[
'phase_position' => 1,
'bricks' => [
[
'brick_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'quantity' => 123,
'discount' => [
[
'rate' => '<string>',
'amount' => 123,
'renews' => false
]
]
]
],
'starts_at' => '2023-12-25',
'contract_length' => 2,
'plan_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'payment_terms' => 499,
'discount_coupons' => [
'<string>'
]
]
],
'point_of_contact_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'signatory_user_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'auto_renews' => true,
'accounts_payable_emails' => [
'jsmith@example.com'
],
'customer_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'payment_terms' => 499,
'renewal_contract_period' => 2,
'renewal_uplifted_rate' => '<string>',
'metadata' => '<unknown>',
'custom_order_form_html' => '<string>',
'accepted_payment_methods_config' => [
'paywall_credit_card' => true,
'paywall_check' => true,
'paywall_ach' => true,
'paywall_wire' => true,
'checkout_credit_card' => true,
'checkout_ach' => true,
'checkout_order_form' => true,
'minimum_order_form_tcv' => 0,
'paywall_force_autopay' => false
],
'purchase_order' => [
'code' => '<string>'
],
'legal_entity_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'adjustment_credit' => 123,
'adjustment_credit_label' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-SALESBRICKS-KEY: <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.salesbricks.com/api/v2/subscriptions/{subscription_id}/recast/{order_id}"
payload := strings.NewReader("{\n \"contract_length\": 2,\n \"plan_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"bricks\": [\n {\n \"brick_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"quantity\": 123,\n \"discount\": [\n {\n \"rate\": \"<string>\",\n \"amount\": 123,\n \"renews\": false\n }\n ]\n }\n ],\n \"discount_coupons\": [\n \"<string>\"\n ],\n \"phases\": [\n {\n \"phase_position\": 1,\n \"bricks\": [\n {\n \"brick_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"quantity\": 123,\n \"discount\": [\n {\n \"rate\": \"<string>\",\n \"amount\": 123,\n \"renews\": false\n }\n ]\n }\n ],\n \"starts_at\": \"2023-12-25\",\n \"contract_length\": 2,\n \"plan_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"payment_terms\": 499,\n \"discount_coupons\": [\n \"<string>\"\n ]\n }\n ],\n \"point_of_contact_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"signatory_user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"auto_renews\": true,\n \"accounts_payable_emails\": [\n \"jsmith@example.com\"\n ],\n \"customer_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"payment_terms\": 499,\n \"renewal_contract_period\": 2,\n \"renewal_uplifted_rate\": \"<string>\",\n \"metadata\": \"<unknown>\",\n \"custom_order_form_html\": \"<string>\",\n \"accepted_payment_methods_config\": {\n \"paywall_credit_card\": true,\n \"paywall_check\": true,\n \"paywall_ach\": true,\n \"paywall_wire\": true,\n \"checkout_credit_card\": true,\n \"checkout_ach\": true,\n \"checkout_order_form\": true,\n \"minimum_order_form_tcv\": 0,\n \"paywall_force_autopay\": false\n },\n \"purchase_order\": {\n \"code\": \"<string>\"\n },\n \"legal_entity_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"adjustment_credit\": 123,\n \"adjustment_credit_label\": \"<string>\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("X-SALESBRICKS-KEY", "<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.salesbricks.com/api/v2/subscriptions/{subscription_id}/recast/{order_id}")
.header("X-SALESBRICKS-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"contract_length\": 2,\n \"plan_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"bricks\": [\n {\n \"brick_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"quantity\": 123,\n \"discount\": [\n {\n \"rate\": \"<string>\",\n \"amount\": 123,\n \"renews\": false\n }\n ]\n }\n ],\n \"discount_coupons\": [\n \"<string>\"\n ],\n \"phases\": [\n {\n \"phase_position\": 1,\n \"bricks\": [\n {\n \"brick_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"quantity\": 123,\n \"discount\": [\n {\n \"rate\": \"<string>\",\n \"amount\": 123,\n \"renews\": false\n }\n ]\n }\n ],\n \"starts_at\": \"2023-12-25\",\n \"contract_length\": 2,\n \"plan_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"payment_terms\": 499,\n \"discount_coupons\": [\n \"<string>\"\n ]\n }\n ],\n \"point_of_contact_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"signatory_user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"auto_renews\": true,\n \"accounts_payable_emails\": [\n \"jsmith@example.com\"\n ],\n \"customer_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"payment_terms\": 499,\n \"renewal_contract_period\": 2,\n \"renewal_uplifted_rate\": \"<string>\",\n \"metadata\": \"<unknown>\",\n \"custom_order_form_html\": \"<string>\",\n \"accepted_payment_methods_config\": {\n \"paywall_credit_card\": true,\n \"paywall_check\": true,\n \"paywall_ach\": true,\n \"paywall_wire\": true,\n \"checkout_credit_card\": true,\n \"checkout_ach\": true,\n \"checkout_order_form\": true,\n \"minimum_order_form_tcv\": 0,\n \"paywall_force_autopay\": false\n },\n \"purchase_order\": {\n \"code\": \"<string>\"\n },\n \"legal_entity_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"adjustment_credit\": 123,\n \"adjustment_credit_label\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.salesbricks.com/api/v2/subscriptions/{subscription_id}/recast/{order_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-SALESBRICKS-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"contract_length\": 2,\n \"plan_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"bricks\": [\n {\n \"brick_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"quantity\": 123,\n \"discount\": [\n {\n \"rate\": \"<string>\",\n \"amount\": 123,\n \"renews\": false\n }\n ]\n }\n ],\n \"discount_coupons\": [\n \"<string>\"\n ],\n \"phases\": [\n {\n \"phase_position\": 1,\n \"bricks\": [\n {\n \"brick_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"quantity\": 123,\n \"discount\": [\n {\n \"rate\": \"<string>\",\n \"amount\": 123,\n \"renews\": false\n }\n ]\n }\n ],\n \"starts_at\": \"2023-12-25\",\n \"contract_length\": 2,\n \"plan_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"payment_terms\": 499,\n \"discount_coupons\": [\n \"<string>\"\n ]\n }\n ],\n \"point_of_contact_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"signatory_user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"auto_renews\": true,\n \"accounts_payable_emails\": [\n \"jsmith@example.com\"\n ],\n \"customer_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"payment_terms\": 499,\n \"renewal_contract_period\": 2,\n \"renewal_uplifted_rate\": \"<string>\",\n \"metadata\": \"<unknown>\",\n \"custom_order_form_html\": \"<string>\",\n \"accepted_payment_methods_config\": {\n \"paywall_credit_card\": true,\n \"paywall_check\": true,\n \"paywall_ach\": true,\n \"paywall_wire\": true,\n \"checkout_credit_card\": true,\n \"checkout_ach\": true,\n \"checkout_order_form\": true,\n \"minimum_order_form_tcv\": 0,\n \"paywall_force_autopay\": false\n },\n \"purchase_order\": {\n \"code\": \"<string>\"\n },\n \"legal_entity_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"adjustment_credit\": 123,\n \"adjustment_credit_label\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"subscription_id": "<string>"
}{
"error": {
"code": "ERR_BAD_REQUEST",
"message": "Bad request — the input payload is malformed, missing required fields, or contains invalid data."
}
}{
"error": {
"code": "ERR_NOT_FOUND",
"message": "Not found — the resource you are looking for does not exist."
}
}Authorizations
API key for authentication
Path Parameters
Pattern:
^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$Pattern:
^([a-zA-Z\d\-]+)$Body
application/jsonapplication/x-www-form-urlencodedmultipart/form-data
Subscription input serializer for recast PATCH operations. Excludes immutable fields: starts_at, currency.
- starts_at: Defaults to current date when recast is created and cannot be changed
- currency: Must remain the same as the original subscription
The length of the contract in months. Required unless phases is provided, in which case it is the sum of the phase lengths.
Required range:
x >= 1The billing frequency. Required unless phases is provided, in which case each phase declares its own billing_frequency.
MONTHLY- MonthlyQUARTERLY- QuarterlySEMI_ANNUALLY- Semi-annuallyANNUALLY- AnnuallyALL_UPFRONT- All upfront
Available options:
MONTHLY, QUARTERLY, SEMI_ANNUALLY, ANNUALLY, ALL_UPFRONT The ID of the plan. Required unless every phase declares its own plan_id — it is the plan for any phase that does not.
The bricks included in the subscription. Required unless phases is provided, in which case every brick comes from the phases.
Show child attributes
Show child attributes
Discount coupon codes to apply to the subscription. Currently only supports one discount coupon - only the first one in the list will be applied.
Optional list of phases for multi-phase orders. When provided, ALL phases come from this array (first element = phase 0, second = phase 1, etc.) and starts_at, contract_length, billing_frequency and bricks become optional — omit them and they are derived from the phases. plan_id is still required, and every brick in every phase must belong to it. When absent, the order-level fields define a single phase.
Show child attributes
Show child attributes
The ID of the point of contact (Person) object
The ID of the signatory user (Person) object
Whether the subscription auto-renews. Defaults to true.
List of email addresses for accounts payable contacts
The ID of the customer
The number of days from an invoice being generated that the buyer is expected to pay in
Required range:
0 <= x <= 999The contract period for renewals in months. If null, inherits from initial contract period.
Required range:
x >= 1The percentage rate to uplift renewal pricing. If null, no uplift is applied.
Pattern:
^-?\d{0,3}(?:\.\d{0,2})?$The medium by which the order is agreed.
ORDER_FORM- Order formSTRIPE- Stripe
Available options:
ORDER_FORM, STRIPE Optional metadata to add to the subscription. Sending an empty map will delete all keys. Keys prefixed with _ are private and will be ignored.
The custom order form html to use with <html><body>...</body></html> formatting
Configuration for accepted payment methods during checkout and paywall
Show child attributes
Show child attributes
When the first invoice should be charged. If not provided, defaults to seller's first_charge_date setting, or CHECKOUT_DATE if seller has no setting.
CONTRACT_START_DATE- Contract Start DateCHECKOUT_DATE- Checkout Date
Available options:
CONTRACT_START_DATE, CHECKOUT_DATE Purchase order for the subscription. Applies to every invoice generated for it, unless an invoice carries its own override. Omit or pass null for no change; pass an empty object or an empty code to clear.
Show child attributes
Show child attributes
Optional ID of the legal entity that issues this subscription. Falls back to the seller's default legal entity when omitted.
Credit that will be applied against future invoices. Send null to clear a manual override and re-enable auto-calculation.
The label for the adjustment credit. Defaults to 'Adjustment credit'