> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usefini.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Manage workspace-wide saved replies with the Macros API.

Macros are shared Markdown reply templates for the [native Inbox composer](/en/testing/inbox#saved-replies-with-macros). These endpoints manage templates; they do not send messages, execute Actions, or substitute variables. The dashboard fills supported variables when a teammate inserts a macro into a conversation.

The authenticated workspace determines ownership. Do not send a company ID or agent ID. Author attribution does not restrict a macro to its creator.

## Endpoints

<CardGroup cols={2}>
  <Card title="List macros" icon="list" href="/en/api-reference/list-macros">List or search saved replies.</Card>
  <Card title="Get macro" icon="message" href="/en/api-reference/get-macro">Read a single template.</Card>
  <Card title="Create macro" icon="plus" href="/en/api-reference/create-macro">Add a workspace-wide template.</Card>
  <Card title="Update macro" icon="pen" href="/en/api-reference/update-macro">Change its title or message.</Card>
  <Card title="Delete macro" icon="trash" href="/en/api-reference/delete-macro">Remove a saved template.</Card>
</CardGroup>

## Macro object

<ResponseField name="id" type="string">Macro UUID.</ResponseField>
<ResponseField name="companyId" type="string">Owning workspace UUID, derived from authentication.</ResponseField>
<ResponseField name="title" type="string">Trimmed title, up to 150 characters. Unique within the workspace, ignoring capitalization and surrounding spaces.</ResponseField>
<ResponseField name="body" type="string">Markdown template, up to 10,000 characters after trimming. Placeholders such as `{{attributes.firstName}}` remain literal in API responses.</ResponseField>
<ResponseField name="createdBy" type="string">Creator's user UUID; can be null if the user was deleted.</ResponseField>
<ResponseField name="updatedBy" type="string">Last editor's user UUID; can be null if the user was deleted.</ResponseField>
<ResponseField name="createdAt" type="string">Creation timestamp.</ResponseField>
<ResponseField name="updatedAt" type="string">Last update timestamp.</ResponseField>

Read endpoints require `read` scope. Create, update, and delete require `write` scope. Use a [workspace API key](/en/deploy/api-keys).


## Related topics

- [Overview](/en/api-reference/tags.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.