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.

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
| Resource | What you can do | Scope and tier |
|---|---|---|
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.

- Step 1: Create a token
- Step 2: Choose scopes
- Step 3: Call api.figma.com
- 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.
Related
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.