Templates
Update template
Updates the fields sent from the template.
PATCH
/templates/{id}templates:writeBEHAVIOR
The change is validated and persisted in the key account before responding. Query the returned resource as the source of truth.
EFFECT
It can change the resource and emit the corresponding domain event.
REPETITION
On network failure, confirm the resource status before retrying. Automatically redo only 429 and 5xx with backoff and jitter.
Request
idstring · pathResource identifier.minLength 2 · maxLength 100mandatorynamestring · bodyTemplate name.optionalbodystring · bodyBody with Achadu variables.maxLength 12000optionalmarketplacestring · bodyOptional marketplace.optionalwith_previewboolean · bodyLegacy preference. Offer messages always include a product link preview when available.optionalAuthorization
Bearer ach_live_...Accept
application/jsonScope
templates:writeExecutable example
curl
curl -X PATCH 'https://achadu.com/api/v1/templates/resource_id' \
-H 'Authorization: Bearer ach_live_...' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
--data '{
"name": "My integration",
"body": "string",
"marketplace": "string"
}'Response and errors
Every response includes request_id. Lists add pagination; mutable resources return the persisted state after the operation.
200 application/json
{
"data": {
"id": "tpl_01J...",
"name": "Direct deal",
"body": "{{title}} for {{price}}",
"has_preview": 1,
"created_at": "2026-08-31T18:20:00.000Z"
},
"request_id": "req_01J..."
}200Operation completed.400Invalid parameter, body or transition.401Missing, invalid, expired or revoked key.402The account plan does not release this interface.403A chave precisa do escopo templates:write.404Feature does not exist in this account.409The current state prevents this operation.413The JSON body exceeds 128 KB.429The 120 requests per minute window has been exceeded.