curl --request PATCH \
--url 'https://api-prod.usefini.com/v2/macros/e73b7a87-6eaf-4e77-8d04-5a3f29a52f60/public' \
--header 'Authorization: Bearer fini_your_api_key' \
--header 'Content-Type: application/json' \
--data '{"body": "Hi {{attributes.firstName}}, the updated documents are ready."}'
const response = await fetch('https://api-prod.usefini.com/v2/macros/e73b7a87-6eaf-4e77-8d04-5a3f29a52f60/public', {
method: 'PATCH',
headers: {"Authorization": "Bearer fini_your_api_key", "Content-Type": "application/json"},
body: JSON.stringify({"body": "Hi {{attributes.firstName}}, the updated documents are ready."})
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
import requests
response = requests.patch(
"https://api-prod.usefini.com/v2/macros/e73b7a87-6eaf-4e77-8d04-5a3f29a52f60/public",
headers={"Authorization": "Bearer fini_your_api_key"},
json={"body": "Hi {{attributes.firstName}}, the updated documents are ready."},
)
response.raise_for_status()
data = response.json()
{
"id": "e73b7a87-6eaf-4e77-8d04-5a3f29a52f60",
"companyId": "97c8757b-83be-45aa-9f29-749d03f873fb",
"title": "Documents sent",
"body": "Hi {{attributes.firstName}}, the updated documents are ready.",
"createdBy": "a5dc0132-4998-4be2-a821-910881658bcb",
"updatedBy": "a5dc0132-4998-4be2-a821-910881658bcb",
"createdAt": "2026-10-08T08:00:00.000Z",
"updatedAt": "2026-10-08T08:00:00.000Z"
}
Macros
Update macro
Update the title or message of a shared saved reply.
PATCH
/
v2
/
macros
/
{id}
/
public
curl --request PATCH \
--url 'https://api-prod.usefini.com/v2/macros/e73b7a87-6eaf-4e77-8d04-5a3f29a52f60/public' \
--header 'Authorization: Bearer fini_your_api_key' \
--header 'Content-Type: application/json' \
--data '{"body": "Hi {{attributes.firstName}}, the updated documents are ready."}'
const response = await fetch('https://api-prod.usefini.com/v2/macros/e73b7a87-6eaf-4e77-8d04-5a3f29a52f60/public', {
method: 'PATCH',
headers: {"Authorization": "Bearer fini_your_api_key", "Content-Type": "application/json"},
body: JSON.stringify({"body": "Hi {{attributes.firstName}}, the updated documents are ready."})
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
import requests
response = requests.patch(
"https://api-prod.usefini.com/v2/macros/e73b7a87-6eaf-4e77-8d04-5a3f29a52f60/public",
headers={"Authorization": "Bearer fini_your_api_key"},
json={"body": "Hi {{attributes.firstName}}, the updated documents are ready."},
)
response.raise_for_status()
data = response.json()
{
"id": "e73b7a87-6eaf-4e77-8d04-5a3f29a52f60",
"companyId": "97c8757b-83be-45aa-9f29-749d03f873fb",
"title": "Documents sent",
"body": "Hi {{attributes.firstName}}, the updated documents are ready.",
"createdBy": "a5dc0132-4998-4be2-a821-910881658bcb",
"updatedBy": "a5dc0132-4998-4be2-a821-910881658bcb",
"createdAt": "2026-10-08T08:00:00.000Z",
"updatedAt": "2026-10-08T08:00:00.000Z"
}
Update the title or message of a shared saved reply. See the Macros overview for the shared object and scope model.
Send at least one of
Headers
Path parameters
Body
Non-empty title, up to 150 characters after trimming. Titles must be unique within the workspace, ignoring case and surrounding spaces.
Non-empty Markdown message, up to 10,000 characters after trimming. Variables are stored as template text, not resolved by this endpoint.
title or body; omitted fields remain unchanged. Use non-null strings for supplied fields. The update changes the shared template for future insertion, not messages already sent.
Response
Returns the macro object. Examples use synthetic IDs and timestamps.curl --request PATCH \
--url 'https://api-prod.usefini.com/v2/macros/e73b7a87-6eaf-4e77-8d04-5a3f29a52f60/public' \
--header 'Authorization: Bearer fini_your_api_key' \
--header 'Content-Type: application/json' \
--data '{"body": "Hi {{attributes.firstName}}, the updated documents are ready."}'
const response = await fetch('https://api-prod.usefini.com/v2/macros/e73b7a87-6eaf-4e77-8d04-5a3f29a52f60/public', {
method: 'PATCH',
headers: {"Authorization": "Bearer fini_your_api_key", "Content-Type": "application/json"},
body: JSON.stringify({"body": "Hi {{attributes.firstName}}, the updated documents are ready."})
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
import requests
response = requests.patch(
"https://api-prod.usefini.com/v2/macros/e73b7a87-6eaf-4e77-8d04-5a3f29a52f60/public",
headers={"Authorization": "Bearer fini_your_api_key"},
json={"body": "Hi {{attributes.firstName}}, the updated documents are ready."},
)
response.raise_for_status()
data = response.json()
{
"id": "e73b7a87-6eaf-4e77-8d04-5a3f29a52f60",
"companyId": "97c8757b-83be-45aa-9f29-749d03f873fb",
"title": "Documents sent",
"body": "Hi {{attributes.firstName}}, the updated documents are ready.",
"createdBy": "a5dc0132-4998-4be2-a821-910881658bcb",
"updatedBy": "a5dc0132-4998-4be2-a821-910881658bcb",
"createdAt": "2026-10-08T08:00:00.000Z",
"updatedAt": "2026-10-08T08:00:00.000Z"
}
Errors
400: Invalid parameters or failed field validation.401: Missing or invalid credential.403: Credential lacks the required scope.406: No workspace is associated with the authenticated user.404: Macro not found in this workspace.409: Another macro already uses that title in this workspace.
Was this page helpful?

