Skip to content

Figma API: what the REST API reads and writes, how to sign in, and its rate limits

Better Design

Direct answer

The Figma API is a REST API at https://api.figma.com that lets your own code read Figma files as JSON, render layers as images, and read or post comments. You sign each request with a personal access token, a plan access token or an OAuth app, and the token's scopes decide which endpoints it can call.

A hand-drawn browser window with Figma API written in it and a short list of what it does.

What Figma API is

Each fact comes from the sources listed at the end of this page, read on November 12, 2026.

  • The Figma REST API uses HTTP endpoints at the base URL https://api.figma.com, for example GET https://api.figma.com/v1/files/:key.
  • Figma for Government customers use https://api.figma-gov.com instead.
  • You can authenticate with an OAuth app, a plan access token or a personal access token.
  • Figma recommends an OAuth app when your app acts for other Figma users; the Activity Logs API and Discovery API require one.
  • A personal access token acts as the user who created it and goes in the X-Figma-Token header.
  • Plan access tokens are for Organization and Enterprise plans, are not tied to one user, and can last up to 1 year.
  • Scopes such as file_content:read, file_comments:write and webhooks:write decide which endpoints a token can call.
  • GET file returns a whole file as JSON, where every layer is a node; GET file nodes returns only the nodes you ask for.
  • GET image renders nodes as jpg, png, svg or pdf, and the image links expire after 30 days.
  • You can read, post and delete comments and comment reactions on a file.
  • The Variables REST API can query, create, update and delete variables, but only on the Enterprise plan.
  • Rate limits depend on your seat, the endpoint's tier and the plan that holds the file. Over the limit, the API returns a 429 error with a Retry-After value in seconds.
  • The full API is described in an OpenAPI specification in the figma/rest-api-spec repository.

What the Figma REST API can read and write

Files
What you can do

GET /v1/files/:key returns the file as JSON; GET /v1/files/:key/nodes returns chosen nodes

Scope and tier

file_content:read, Tier 1

Images
What you can do

GET /v1/images/:key renders nodes as jpg, png, svg or pdf

Scope and tier

file_content:read, Tier 1; links expire after 30 days

Comments
What you can do

Read, post and delete comments and reactions

Scope and tier

file_comments:read and file_comments:write, Tier 2

Variables
What you can do

Query, create, update and delete variables and collections

Scope and tier

file_variables:read and file_variables:write, Enterprise plan only

Webhooks
What you can do

Create and manage webhooks

Scope and tier

webhooks:read and webhooks:write, Tier 2

Version history
What you can do

Read the version history of files you can access

Scope and tier

file_versions:read, Tier 2

Get started with Figma API

  • Log in to Figma and open Settings from the account menu in the file browser.
  • Select the Security tab and click Generate new token under Personal access tokens.
  • Set the expiration and the scopes, such as file_content:read, then click Generate token.
  • Copy the token now: Figma shows it only once.
  • Send a request such as GET https://api.figma.com/v1/files/:key with the token in the X-Figma-Token header, using the file key from the file's URL.

Figma API in four steps

The four steps, in the order you take them.

A hand-drawn four-step path for Figma API: Create a token, Choose scopes, Call api.figma.com, Read the JSON.
  1. Step 1: Create a token
  2. Step 2: Choose scopes
  3. Step 3: Call api.figma.com
  4. Step 4: Read the JSON

Caveats Figma API states

  • View and Collab seats can call Tier 1 endpoints such as GET file only up to 20 times a month, and Figma says the real limit may be lower.
  • Scopes do not override file permissions: a token reaches only files you created or that were shared with you.
  • The files:read scope is deprecated; Figma asks you to use granular scopes such as file_content:read instead.
  • The Variables REST API needs the Enterprise plan, and writing variables needs a Full seat and edit access.

Steal this workflow

Run this guide in your own assistant. The prompt carries the guide link and the workflow summary, so the assistant can adapt it to your project.

Read the guide "Figma API: what the REST API reads and writes, how to sign in, and its rate limits" at https://better-design.com/blog/figma-api and help me apply it to my project.

The Figma API is a REST API at https://api.figma.com that lets your own code read Figma files as JSON, render layers as images, and read or post comments. You sign each request with a personal access token, a plan access token or an OAuth app, and the token's scopes decide which endpoints it can call.

Start by asking what I am building and which tools I use. Then walk me through the workflow step by step, adapted to my answers.

Claude and ChatGPT open with the prompt filled in. Gemini copies the prompt to your clipboard first, so paste it when the app opens.

Questions

How do I get a Figma API token?

In Figma, open Settings, select the Security tab and click Generate new token under Personal access tokens. Set the expiration and scopes, then copy the token, because Figma shows it only once.

What are the Figma API rate limits?

They depend on the endpoint tier, your seat and the plan. For Dev and Full seats, Tier 1 endpoints such as GET file allow 10 a minute on Professional, 15 on Organization and 20 on Enterprise. Tier 2 allows 25, 50 and 100, and Tier 3 allows 50, 100 and 150. On a Starter plan, Tier 1 is up to 20 a month.

What is the difference between the Figma REST API and the Plugin API?

The REST API runs from your own script or server and reads files, images, comments and version history over HTTP. The Plugin API runs inside a Figma file when a user starts it, and can view, create and change the layers in that file, but it cannot read comments or version history. Figma points plugins to the REST API for those.

Where these Figma API facts come from

Each fact comes from the pages listed here, read on November 12, 2026. Products change, so check those pages for the current version.

Build the interface in your own code instead

A coding agent such as Claude Code, Cursor or Codex can build your interface in your own code. Better Design gives that agent a design system, interface principles and review rules, so the result looks designed.