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.
Input Schema
TableJSON 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) |