query_shapes
Query and filter shapes by type, color, area, or text. Returns only specified fields for bulk edits like retheming or alignment.
Instructions
Query and filter shapes with multiple criteria (like grep for shapes). Useful for bulk operations like changing color themes, alignment, or filtering by area/type. Returns only the requested fields.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"fileId": "<fileId>",
"pageId": "<pageId>"
},
"name": "query_shapes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| maxX | No | Maximum X position (area filter) | |
| maxY | No | Maximum Y position (area filter) | |
| minX | No | Minimum X position (area filter) | |
| minY | No | Minimum Y position (area filter) | |
| types | No | Filter by shape types (e.g., ["text", "rectangle", "circle"]) | |
| fields | No | Fields to return: "position" (x,y,width,height), "colors" (fill,stroke), "text" (font props), "effects" (shadow,blur), "all". Default: ["position"] | |
| fileId | Yes | File ID | |
| pageId | Yes | Page ID | |
| fillColor | No | Filter by fill color (HEX, e.g., "#FF0000") | |
| fontFamily | No | Filter by font family (for text shapes) | |
| namePattern | No | Filter by name pattern (regex) | |
| strokeColor | No | Filter by stroke color (HEX) | |
| textContent | No | Filter by text content (case-insensitive substring match) |