Lists
Organize brands and contacts into saved lists — the same lists you see in the app. Reads are instant; writes preview first.
note
Every action that changes your data (create, rename, delete, add, remove) previews first: your assistant shows you exactly what will happen and only runs it once you confirm.
get_lists
Return all saved lists in the workspace.
Returns
List of { id, name, list_type, icon, item_count }.
Example prompt
"Show me all my lists"
create_list
Create a new saved list.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
name | string | Yes | List name |
list_type | string | Yes | "Brand" or "Person" — what the list holds |
icon | string | No | Optional emoji/icon |
Example prompt
"Create a brand list called 'Q3 fintech targets'"
rename_list
Rename a list or change its icon.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
list_id | string | Yes | The list to rename |
name | string | No | New name |
icon | string | No | New icon |
delete_list
Permanently delete a list and its membership. Irreversible.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
list_id | string | Yes | The list to delete |
add_brands_to_list / add_contacts_to_list
Add brands (or people) to an existing list.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
list_id | string | Yes | Target list |
brands / contacts | string[] | Yes | Names to add |
Example prompt
"Add Decathlon and Nike to my 'Q3 fintech targets' list"
remove_brands_from_list / remove_contacts_from_list
Remove brands (or people) from a list.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
list_id | string | Yes | Target list |
brands / contacts | string[] | Yes | Names to remove |