What it does
Update an agent command. Send the fields that change. name renames it.
Plans
Works on every plan: Free, Basic, Pro and Ultra.
Parameters
| Name | Type | About |
|---|---|---|
site_idrequired | string | The id of the site. list_sites gives the ids of your sites. |
namerequired | string | The command to change. |
new_name | string | A new name for the command. |
kind | one of: fixed, free | fixed or free. |
label | string or null | The text on the command's button. null clears it. |
instruction | string or null | For fixed: what the agent should do. Put {input} where the visitor's text goes. |
input_max | integer or null | The most characters a visitor may type. |
access | one of: off, owner, share, member | Who may send it: off, owner, share or member. |
deliver_to | one of: owner, sender | owner or sender: whose agent gets the calls. |
Example
Call update_command with these arguments:
{
"site_id": "01a1…",
"name": "summarize",
"label": "Ask about recipes"
}
Ids like 01a1… stand for your own. list_sites and list_tables give you the real ones.
Related guides
- What agent commands areButtons and forms that send your agent a task.
- Connect a WebhookStart your agent the moment a command comes in.