Update a template
PATCH
/templates/{id}Authorization
AuthorizationBearer token · headerrequiredA BillionSend API key (bs_…).
Path parameters
idstringrequiredTemplate id or alias
min length 1
Request body
application/jsonnamestringmin length 1 · max length 200
subjectstring | null"" or null clears the subject
max length 998
htmlstringmin length 1 · max length 500000
textstring | nullmax length 500000
aliasstring | nullnull clears the alias
min length 1 · max length 100 · matches ^[A-Za-z0-9][A-Za-z0-9._-]*$
fromstring | nullNot supported yet: any value is a 422
reply_tostring | string[] | nullNot supported yet: any value is a 422
Show propertiesHide properties
Any of:
string
stringstring[]
Array of
stringstringnull
nullvariablesany[]Not supported yet: a non-empty list is a 422
Responses
200
Template updated (live immediately)
objectstringrequiredAllowed:
templateidstring<uuid>required401
Missing, malformed, unknown or revoked API key
statusCodenumberrequirednamestringrequiredmessagestringrequired404
Not found
statusCodenumberrequirednamestringrequiredmessagestringrequired409
Alias already in use
statusCodenumberrequirednamestringrequiredmessagestringrequired422
Validation error, including from/reply_to/variables (not supported yet)
statusCodenumberrequirednamestringrequiredmessagestringrequired429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberrequirednamestringrequiredmessagestringrequired