figma.api.* operation is listed below with parameter shapes and return types from the plugin Zod schemas.
Activity Logs
list
activityLogs.list
List Figma organization activity logs
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
start_time | number | No | — |
end_time | number | No | — |
limit | number | No | — |
order | string | No | — |
events | string | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
activity_logs | any[] | No | — |
cursor | string | No | — |
next_page | boolean | No | — |
Comments
add
comments.add
Add a comment to a Figma file
Risk: write
| Name | Type | Required | Description |
|---|---|---|---|
message | string | Yes | — |
file_key | string | Yes | — |
comment_id | string | No | — |
client_meta | any | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | — |
uuid | string | No | — |
message | string | No | — |
file_key | string | No | — |
order_id | string | No | — |
parent_id | string | No | — |
reactions | object[] | No | — |
created_at | string | No | — |
client_meta | any | No | — |
resolved_at | string | No | — |
user | object | No | — |
reactions full type
reactions full type
user full type
user full type
addReaction
comments.addReaction
Add a reaction to a comment
Risk: write
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
comment_id | string | Yes | — |
emoji | string | Yes | — |
| Name | Type | Required | Description |
|---|---|---|---|
status | number | No | — |
error | boolean | No | — |
delete
comments.delete
Delete a comment from a Figma file [DESTRUCTIVE]
Risk: destructive
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
comment_id | string | Yes | — |
| Name | Type | Required | Description |
|---|---|---|---|
status | number | No | — |
error | boolean | No | — |
deleteReaction
comments.deleteReaction
Delete a reaction from a comment
Risk: write
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
comment_id | string | Yes | — |
emoji | string | Yes | — |
| Name | Type | Required | Description |
|---|---|---|---|
status | number | No | — |
error | boolean | No | — |
getReactions
comments.getReactions
Get reactions on a comment
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
comment_id | string | Yes | — |
cursor | string | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
reactions | object[] | No | — |
pagination | object | No | — |
reactions full type
reactions full type
pagination full type
pagination full type
list
comments.list
List comments on a Figma file
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
as_md | boolean | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
comments | object[] | No | — |
comments full type
comments full type
Components
get
components.get
Get a Figma component by key
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
key | string | Yes | — |
| Name | Type | Required | Description |
|---|---|---|---|
meta | object | No | — |
status | number | No | — |
meta full type
meta full type
getComponentSet
components.getComponentSet
Get a Figma component set by key
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
key | string | Yes | — |
| Name | Type | Required | Description |
|---|---|---|---|
meta | object | No | — |
status | number | No | — |
meta full type
meta full type
getComponentSetsForFile
components.getComponentSetsForFile
Get all component sets in a Figma file
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
| Name | Type | Required | Description |
|---|---|---|---|
meta | object | No | — |
meta full type
meta full type
getComponentSetsForTeam
components.getComponentSetsForTeam
Get all component sets for a Figma team
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | — |
page_size | number | No | — |
after | number | No | — |
before | number | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
meta | object | No | — |
cursor | string | No | — |
meta full type
meta full type
getForFile
components.getForFile
Get all components in a Figma file
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
| Name | Type | Required | Description |
|---|---|---|---|
meta | object | No | — |
status | number | No | — |
meta full type
meta full type
getForTeam
components.getForTeam
Get all components for a Figma team
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | — |
page_size | number | No | — |
after | number | No | — |
before | number | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
meta | object | No | — |
cursor | string | No | — |
meta full type
meta full type
Design Tools
designTokensToTailwind
designTools.designTokensToTailwind
Convert Figma design tokens to a Tailwind CSS configuration
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
tokens | object | Yes | — |
prefix | string | No | — |
config_format | string | No | — |
include_font_imports | boolean | No | — |
tokens full type
tokens full type
| Name | Type | Required | Description |
|---|---|---|---|
config | string | No | — |
css | string | No | — |
discoverResources
designTools.discoverResources
Discover Figma files, projects, and teams
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
figma_url | string | No | — |
file_key | string | No | — |
team_id | string | No | — |
project_id | string | No | — |
max_depth | number | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
files | any[] | No | — |
projects | any[] | No | — |
teams | any[] | No | — |
downloadImages
designTools.downloadImages
Download rendered images for Figma nodes
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
images | object[] | Yes | — |
scale | number | No | — |
svg_include_id | boolean | No | — |
svg_outline_text | boolean | No | — |
svg_simplify_stroke | boolean | No | — |
images full type
images full type
| Name | Type | Required | Description |
|---|---|---|---|
images | object | No | — |
images full type
images full type
extractDesignTokens
designTools.extractDesignTokens
Extract design tokens (variables and styles) from a Figma file
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
include_variables | boolean | No | — |
include_local_styles | boolean | No | — |
extract_from_nodes | string | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
tokens | object | No | — |
tokens full type
tokens full type
extractPrototypeInteractions
designTools.extractPrototypeInteractions
Extract prototype interactions and flows from a Figma file
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
analyze_components | boolean | No | — |
include_animations | boolean | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
interactions | any[] | No | — |
flows | any[] | No | — |
Dev Resources
create
devResources.create
Create dev resources on a Figma file
Risk: write
| Name | Type | Required | Description |
|---|---|---|---|
dev_resources | object[] | Yes | — |
dev_resources full type
dev_resources full type
| Name | Type | Required | Description |
|---|---|---|---|
links_created | object[] | No | — |
errors | object[] | No | — |
links_created full type
links_created full type
errors full type
errors full type
delete
devResources.delete
Delete a dev resource from a Figma file [DESTRUCTIVE]
Risk: destructive
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
dev_resource_id | string | Yes | — |
get
devResources.get
Get dev resources for a Figma file
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
node_ids | string | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
dev_resources | object[] | No | — |
dev_resources full type
dev_resources full type
update
devResources.update
Update dev resources on a Figma file
Risk: write
| Name | Type | Required | Description |
|---|---|---|---|
dev_resources | object[] | Yes | — |
dev_resources full type
dev_resources full type
| Name | Type | Required | Description |
|---|---|---|---|
links_updated | object[] | No | — |
errors | object[] | No | — |
links_updated full type
links_updated full type
errors full type
errors full type
Files
getImageFills
files.getImageFills
Get image fills from a Figma file
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
| Name | Type | Required | Description |
|---|---|---|---|
meta | object | No | — |
error | boolean | No | — |
meta full type
meta full type
getJSON
files.getJSON
Get full Figma file JSON
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
version | string | No | — |
ids | string | No | — |
depth | number | No | — |
geometry | string | No | — |
plugin_data | string | No | — |
branch_data | boolean | No | — |
simplify | boolean | No | — |
include_raw | boolean | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
name | string | No | — |
role | string | No | — |
lastModified | string | No | — |
editorType | string | No | — |
thumbnailUrl | string | No | — |
version | string | No | — |
document | any | No | — |
components | object | No | — |
styles | object | No | — |
components full type
components full type
styles full type
styles full type
getMetadata
files.getMetadata
Get Figma file metadata
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
| Name | Type | Required | Description |
|---|---|---|---|
name | string | No | — |
role | string | No | — |
last_modified | string | No | — |
editorType | string | No | — |
thumbnail_url | string | No | — |
version | string | No | — |
getNodes
files.getNodes
Get specific nodes from a Figma file
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
ids | string | Yes | — |
version | string | No | — |
depth | number | No | — |
geometry | string | No | — |
plugin_data | string | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
name | string | No | — |
nodes | object | No | — |
nodes full type
nodes full type
getProjectFiles
files.getProjectFiles
Get all files in a Figma project
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
project_id | string | Yes | — |
branch_data | boolean | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
name | string | No | — |
files | object[] | No | — |
files full type
files full type
getStyles
files.getStyles
Get styles from a Figma file
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
| Name | Type | Required | Description |
|---|---|---|---|
meta | object | No | — |
meta full type
meta full type
getVersions
files.getVersions
Get version history of a Figma file
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
page_size | number | No | — |
before | number | No | — |
after | number | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
versions | object[] | No | — |
pagination | object | No | — |
versions full type
versions full type
pagination full type
pagination full type
renderImages
files.renderImages
Render Figma nodes as images
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
ids | string | Yes | — |
scale | number | No | — |
format | jpg | png | svg | pdf | No | — |
version | string | No | — |
contents_only | boolean | No | — |
svg_include_id | boolean | No | — |
svg_outline_text | boolean | No | — |
svg_include_node_id | boolean | No | — |
svg_simplify_stroke | boolean | No | — |
use_absolute_bounds | boolean | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
images | object | No | — |
err | string | No | — |
images full type
images full type
Library Analytics
componentActions
libraryAnalytics.componentActions
Get library component action analytics
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
start_date | string | No | — |
end_date | string | No | — |
group_by | string | No | — |
cursor | string | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
rows | any[] | No | — |
cursor | string | No | — |
next_page | boolean | No | — |
componentUsages
libraryAnalytics.componentUsages
Get library component usage analytics
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
group_by | string | No | — |
cursor | string | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
rows | any[] | No | — |
cursor | string | No | — |
next_page | boolean | No | — |
styleActions
libraryAnalytics.styleActions
Get library style action analytics
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
start_date | string | No | — |
end_date | string | No | — |
group_by | string | No | — |
cursor | string | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
rows | any[] | No | — |
cursor | string | No | — |
next_page | boolean | No | — |
styleUsages
libraryAnalytics.styleUsages
Get library style usage analytics
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
group_by | string | No | — |
cursor | string | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
rows | any[] | No | — |
cursor | string | No | — |
next_page | boolean | No | — |
variableActions
libraryAnalytics.variableActions
Get library variable action analytics
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
start_date | string | No | — |
end_date | string | No | — |
group_by | string | No | — |
cursor | string | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
rows | any[] | No | — |
cursor | string | No | — |
next_page | boolean | No | — |
variableUsages
libraryAnalytics.variableUsages
Get library variable usage analytics
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
group_by | string | No | — |
cursor | string | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
rows | any[] | No | — |
cursor | string | No | — |
next_page | boolean | No | — |
Payments
get
payments.get
Get payment information for a Figma plugin or widget
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
user_id | string | No | — |
plugin_id | string | No | — |
widget_id | string | No | — |
community_file_id | string | No | — |
plugin_payment_token | string | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
meta | object | No | — |
status | number | No | — |
meta full type
meta full type
Projects
getTeamProjects
projects.getTeamProjects
Get all projects for a Figma team
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | — |
| Name | Type | Required | Description |
|---|---|---|---|
name | string | No | — |
projects | object[] | No | — |
projects full type
projects full type
Styles
get
styles.get
Get a Figma style by key
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
key | string | Yes | — |
| Name | Type | Required | Description |
|---|---|---|---|
meta | object | No | — |
meta full type
meta full type
getForTeam
styles.getForTeam
Get all styles for a Figma team
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | — |
page_size | number | No | — |
after | number | No | — |
before | number | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
meta | object | No | — |
meta full type
meta full type
Users
getCurrent
users.getCurrent
Get the currently authenticated Figma user
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | — |
handle | string | No | — |
img_url | string | No | — |
email | string | No | — |
Variables
createModifyDelete
variables.createModifyDelete
Create, modify, or delete variables in a Figma file
Risk: write
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
variables | any[] | No | — |
variableModes | any[] | No | — |
variableModeValues | any[] | No | — |
variableCollections | any[] | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
meta | object | No | — |
status | number | No | — |
error | boolean | No | — |
meta full type
meta full type
getLocal
variables.getLocal
Get local variables from a Figma file
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
| Name | Type | Required | Description |
|---|---|---|---|
meta | object | No | — |
status | number | No | — |
error | boolean | No | — |
meta full type
meta full type
getPublished
variables.getPublished
Get published variables from a Figma file
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
file_key | string | Yes | — |
| Name | Type | Required | Description |
|---|---|---|---|
meta | object | No | — |
status | number | No | — |
error | boolean | No | — |
meta full type
meta full type
Webhooks
create
webhooks.create
Create a Figma webhook
Risk: write
| Name | Type | Required | Description |
|---|---|---|---|
event_type | string | Yes | — |
endpoint | string | Yes | — |
passcode | string | Yes | — |
status | ACTIVE | PAUSED | No | — |
context | string | No | — |
context_id | string | No | — |
team_id | string | No | — |
description | string | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | — |
status | ACTIVE | PAUSED | No | — |
context | team | project | file | No | — |
team_id | string | No | — |
endpoint | string | No | — |
passcode | string | No | — |
client_id | string | No | — |
context_id | string | No | — |
event_type | string | No | — |
description | string | No | — |
delete
webhooks.delete
Delete a Figma webhook [DESTRUCTIVE]
Risk: destructive
| Name | Type | Required | Description |
|---|---|---|---|
webhook_id | string | Yes | — |
| Name | Type | Required | Description |
|---|---|---|---|
id | string | No | — |
status | ACTIVE | PAUSED | No | — |
context | team | project | file | No | — |
team_id | string | No | — |
endpoint | string | No | — |
passcode | string | No | — |
client_id | string | No | — |
context_id | string | No | — |
event_type | string | No | — |
description | string | No | — |
get
webhooks.get
Get a Figma webhook by ID
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
webhook_id | string | Yes | — |
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | — |
status | ACTIVE | PAUSED | No | — |
context | team | project | file | No | — |
team_id | string | No | — |
endpoint | string | No | — |
passcode | string | No | — |
client_id | string | No | — |
context_id | string | No | — |
event_type | string | No | — |
description | string | No | — |
getRequests
webhooks.getRequests
Get webhook request history
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
webhook_id | string | Yes | — |
| Name | Type | Required | Description |
|---|---|---|---|
requests | object[] | No | — |
requests full type
requests full type
list
webhooks.list
List Figma webhooks
Risk: read
| Name | Type | Required | Description |
|---|---|---|---|
context | string | No | — |
context_id | string | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
webhooks | object[] | No | — |
webhooks full type
webhooks full type
update
webhooks.update
Update a Figma webhook
Risk: write
| Name | Type | Required | Description |
|---|---|---|---|
webhook_id | string | Yes | — |
event_type | string | No | — |
endpoint | string | No | — |
passcode | string | No | — |
status | ACTIVE | PAUSED | No | — |
description | string | No | — |
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | — |
status | ACTIVE | PAUSED | No | — |
context | team | project | file | No | — |
team_id | string | No | — |
endpoint | string | No | — |
passcode | string | No | — |
client_id | string | No | — |
context_id | string | No | — |
event_type | string | No | — |
description | string | No | — |