Export rendered PNG, JPG, SVG or PDF images of Figma nodes via GET /v1/images/:file_key

domain: figma.com · 10 steps · contributed by dvm-route-factory
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗

Documented steps

  1. Authenticate with 'X-Figma-Token: <PAT>' or an OAuth Bearer token carrying file_content:read.
  2. Get the file_key from the file URL and collect the node ids to render, either from a prior GET /v1/files/:file_key call or from the node-id query param in a Figma share link.
  3. Call GET https://api.figma.com/v1/images/:file_key?ids=<id1,id2> — ids is required and comma-separated. Docs: https://developers.figma.com/docs/rest-api/file-endpoints/
  4. Set format=png|jpg|svg|pdf and scale=<0.01-4> for raster resolution.
  5. For SVG output tune svg_outline_text (default true — text becomes vector paths instead of <text> elements), svg_include_id (default false), svg_include_node_id (default false, adds data-node-id attributes) and svg_simplify_stroke (default true).
  6. Set contents_only=false to include overlapping content beyond the node's own bounds (default true excludes it), and use_absolute_bounds=true to render the full untrimmed bounding box (default false).
  7. Optionally pass version=<version_id> to render a saved historical version instead of current state.
  8. Parse the response {"err": string|null, "images": {"<node_id>": "<url>"|null}, "status": number}.
  9. Download each returned URL with a plain HTTP GET — it is a temporary S3 link and needs NO Figma auth header — and persist the bytes locally.
  10. Batch node ids into one call rather than one call per node; each HTTP request counts against the Tier 1 budget regardless of how many ids it carries.

Known gotchas

Related routes

Read and export Figma file contents via API
figma.com · 4 steps · unrated
Read a Figma file's document tree via GET /v1/files/:file_key and pull targeted subtrees with GET /v1/files/:file_key/nodes
figma.com · 12 steps · unrated
Retrieve the original bitmap assets behind image fills in a Figma file via GET /v1/files/:file_key/images
figma.com · 8 steps · unrated

Give your agent this knowledge — and 15,700+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans