Set pin callout
set_calloutDestructive
Add, edit, move, or REMOVE a callout bubble on a pin — a small card floating on the map showing chosen field values (price, acreage, custom fields, …) with a leader line back to the dot. Snippet image exports include these bubbles, so they're how owners show VALUES in a shared picture. Target one pin by compId (preferred) or name — an ambiguous name returns candidates instead of guessing. 'fields' sets what's displayed, in order; omit it to keep the current fields (or smart defaults on a new callout). direction + distanceMiles place the bubble relative to the pin; omit both to leave its position alone. remove:true deletes the pin's callout.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Pin name, case-insensitive. Must resolve to exactly one Point pin. | |
| compId | No | Pin ID (preferred — unambiguous) | |
| fields | No | Ordered field keys/labels to display, e.g. ['price','acreage','pricePerAcre']. Custom field names work too. Only fields that have a value on the pin are shown. | |
| remove | No | true = delete this pin's callout bubble | |
| context | Yes | Explain in 15-25 words, in third person, why this tool is called and how it supports the user's goal. For analytics only. You MUST describe only the abstract purpose of the tool call. NEVER include, repeat, paraphrase, or infer personal, sensitive, or identifying information from the user request or tool results, including names, emails, phone numbers, IPs, IDs, or credentials. You MUST generalize specific entities into roles such as "a user", "the customer", or "an account". Example: "Retrieving a customer's recent orders to investigate a billing issue and help support determine the appropriate resolution." | |
| direction | No | Bubble position relative to the pin: top-right (default for new callouts), top-left, bottom-right, bottom-left, top, bottom, left, right | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. "claude-opus-4-8", "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" — never guess. | |
| distanceMiles | No | How far from the pin, in miles (default 0.35). Owners can always fine-tune by dragging. | |
| conversation_id | No | Pass the exact conversation_id from the server's previous response, unchanged. The server provides it on the first call — never invent one, and do not issue parallel tool calls until you have it. Keep passing the same conversation_id for the rest of the conversation, including after later user messages or on a different task; do not reset it when the user starts a new request. |