List the document's pages; no args → all pages (no children), or pass pageIds → those pages with their top-level children. Batch ≤25 ids/call. Inspect coverage: a failed page is omitted with a structured pageErrors row while other pages still return.

Read one or more nodes — recursive subtree traversal with properties selection, filter, and maxDepth. Returns only the requested properties (incl. resolved boundVariables/explicitVariableModes) under each node's properties key. A node whose containing page could not be read is listed in pageFailedNodes with that page's ID, and the page's structured reason is in coverage.pageErrors — other pages still return normally. The workhorse read; start here before any write.

Move and/or resize a node by setting absolute x/y/width/height (any subset).

Rename a node (sets name to an exact value).

Delete one or more nodes in a single batched, per-item-validated call. No API undo. If the status is 'partial_success', treat it as an incomplete operation, report the failed and skipped items to the user, and retry every non-success item (both failed and skipped).

Duplicate an existing node, optionally at a new x/y. Produces a new node id.

Navigate the editor view to a page or node(s).

Wrap multiple nodes in a new group node.

Dissolve a group, promoting its children to the parent. Removes the group container.

Flatten a node and its children into a single vector. Lossy — original structure is not recoverable.

Reparent a node under a new parent at an optional index. Valid range is 0 to parent's child count. Omit index to append.

Configure a frame's auto-layout (mode, padding, spacing, alignment, sizing) in one unified setter.

Set a node's fill to a literal RGBA color, an image, or clear it. Use node_apply_style to link a shared paint style, or node_bind_variable to bind a color token.

Set a node's stroke color and weight; supports uniform or per-side weights.

Set a node's corner radius — uniform or per-corner.

Set a node's effect array (shadows, blurs). Use node_apply_style to link a shared effect style instead.

Link a node to a shared library style (paint/text/effect/grid) by styleId. Use the raw node_set_* setters for ad-hoc values not backed by a style.

Bind a variable to a node property, or set an explicit variable mode. Use instead of a literal node_set_* when the value should track a design token. Ordering rules: set auto-layout before binding padding/spacing; set a solid fill before binding a colour token.

Render a node to an image (PNG/JPG/SVG/PDF) at a given scale. Read-only; the canonical way to visually verify edits. SVG returns raw XML in svg (directly readable); PNG/JPG/PDF return base64 in imageData (PDF is a delivery artifact — prefer PNG/SVG for inspection).

Create a rectangle, ellipse, polygon, or star via type, with position/size and optional fillColor/strokeColor. Shape-specific params (arcData; pointCount/innerRadius) validated by type. pointCount = sides (polygon) or points (star), native count — no even-parity rule.

Create a frame (container) with optional fill/stroke and full auto-layout configuration.

Create a text node with content and optional font size/weight/color.

Create a node from an SVG markup string.

Convert an existing frame into a main component.

Instantiate a component (by componentKey or componentId) at a position.

Combine components into a component set (variants) with property definitions.

List all local styles (paint/text/effect/grid) in the document.

Create a named style (paint/text/effect/grid), or update an existing one when styleId is given. UPDATE requires currentStyleName.

Delete a local style by id. Detaches consumers — they keep their resolved values and lose only the style link.

Set the text of one or more text nodes in a single batched, per-item-validated call. If the status is 'partial_success', treat it as an incomplete operation, report the failed and skipped items to the user, and retry every non-success item (both failed and skipped).

Set any combination of typography properties (font, size, weight, spacing, decoration, …) on a text node.

List components in the document, with filtering and scope options. Document scans isolate page failures and report them in coverage; page-scoped failures return their structured error directly.

Add or edit a component-property definition (BOOLEAN/TEXT/INSTANCE_SWAP) on a main component or variant set. Deleting is component_delete_property.

Remove a component-property definition from a main component or variant set; propagates to every instance.

Set one property on an instance — boolean toggle, text override, instance swap, or variant selection.

Read the override properties from a source instance, to later apply them to other instances.

Apply previously-read overrides to target instances; targets are swapped to the source component and all overrides applied. If the status is 'partial_success', treat it as an incomplete operation, report the failed and skipped items to the user, and retry every non-success item (both failed and skipped).

List local variables/collections, or detailed info for specific variable ids; optionally scan for consumers. Document consumer scans isolate page failures and report them in coverage; page-scoped failures return their structured error directly.

Create collections and variables and set their values/aliases (create/update router). UPDATE_VARIABLE requires currentVariableName. CREATE_VARIABLE requires collectionName and scopes.

Delete specific variables or an entire collection. Runs a full-document consumer check first, before any removal: if a target is still in use the call is refused with VARIABLE_IN_USE, whose details.variablesInUse lists every consumer; if any page cannot be loaded and read it is refused with DOCUMENT_SCAN_INCOMPLETE, because a page error can never mean zero consumers.

Read the native annotations on a page or node (and subtree); exactly one of pageId or nodeId is required. The file's annotation categories are returned by default; pass includeCategories: false to omit them. Page loading is bounded; a page-scoped failure returns its structured error directly and successful reads include coverage.

Append native annotations to one or more nodes in a batched call. If the status is 'partial_success', treat it as an incomplete operation and report the failed and skipped items to the user. Appending is NOT idempotent and a 'failed' row may already have appended its annotation (verified counts differ, or outcomeUnknown is true when post-state is unreadable; both carry partialMutation: true) — before retrying any non-success item, call annotation_list and compare the labels already on the node, or you will create a duplicate.

Read prototype reactions from one or more nodes and their descendants.

Replace a node's prototype reactions with a full new reactions array (read first via reaction_list).

Join a plugin channel to establish the live connection to the Figma document.