---
name: figma-api
description: "Figma API skill. Use when working with Figma for files, images, teams. Covers 47 endpoints."
version: 1.0.0
generator: lapsh
---

# Figma API
API version: 0.37.0

## Auth
ApiKey X-Figma-Token in header | OAuth2 | OAuth2

## Base URL
https://api.figma.com

## Setup
1. Set your API key in the appropriate header
2. GET /v1/me -- get current user
3. POST /v1/files/{file_key}/comments -- create first comment

## Endpoints
47 endpoints across 14 groups. See references/api-spec.lap for full details.

### Files
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/files/{file_key} | Get file JSON |
| GET | /v1/files/{file_key}/nodes | Get file JSON for specific nodes |
| GET | /v1/files/{file_key}/images | Get image fills |
| GET | /v1/files/{file_key}/meta | Get file metadata |
| GET | /v1/files/{file_key}/versions | Get versions of a file |
| GET | /v1/files/{file_key}/comments | Get comments in a file |
| POST | /v1/files/{file_key}/comments | Add a comment to a file |
| DELETE | /v1/files/{file_key}/comments/{comment_id} | Delete a comment |
| GET | /v1/files/{file_key}/comments/{comment_id}/reactions | Get reactions for a comment |
| POST | /v1/files/{file_key}/comments/{comment_id}/reactions | Add a reaction to a comment |
| DELETE | /v1/files/{file_key}/comments/{comment_id}/reactions | Delete a reaction |
| GET | /v1/files/{file_key}/components | Get file components |
| GET | /v1/files/{file_key}/component_sets | Get file component sets |
| GET | /v1/files/{file_key}/styles | Get file styles |
| GET | /v1/files/{file_key}/variables/local | Get local variables |
| GET | /v1/files/{file_key}/variables/published | Get published variables |
| POST | /v1/files/{file_key}/variables | Create/modify/delete variables |
| GET | /v1/files/{file_key}/dev_resources | Get dev resources |
| DELETE | /v1/files/{file_key}/dev_resources/{dev_resource_id} | Delete dev resource |

### Images
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/images/{file_key} | Render images of file nodes |

### Teams
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/teams/{team_id}/projects | Get projects in a team |
| GET | /v1/teams/{team_id}/components | Get team components |
| GET | /v1/teams/{team_id}/component_sets | Get team component sets |
| GET | /v1/teams/{team_id}/styles | Get team styles |
| GET | /v2/teams/{team_id}/webhooks | [Deprecated] Get team webhooks |

### Projects
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/projects/{project_id}/files | Get files in a project |

### Me
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/me | Get current user |

### Components
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/components/{key} | Get component |

### Component_sets
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/component_sets/{key} | Get component set |

### Styles
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/styles/{key} | Get style |

### Webhooks
| Method | Path | Description |
|--------|------|-------------|
| GET | /v2/webhooks | Get webhooks by context or plan |
| POST | /v2/webhooks | Create a webhook |
| GET | /v2/webhooks/{webhook_id} | Get a webhook |
| PUT | /v2/webhooks/{webhook_id} | Update a webhook |
| DELETE | /v2/webhooks/{webhook_id} | Delete a webhook |
| GET | /v2/webhooks/{webhook_id}/requests | Get webhook requests |

### Activity_logs
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/activity_logs | Get activity logs |

### Payments
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/payments | Get payments |

### Dev_resources
| Method | Path | Description |
|--------|------|-------------|
| POST | /v1/dev_resources | Create dev resources |
| PUT | /v1/dev_resources | Update dev resources |

### Analytics
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/analytics/libraries/{file_key}/component/actions | Get library analytics component action data. |
| GET | /v1/analytics/libraries/{file_key}/component/usages | Get library analytics component usage data. |
| GET | /v1/analytics/libraries/{file_key}/style/actions | Get library analytics style action data. |
| GET | /v1/analytics/libraries/{file_key}/style/usages | Get library analytics style usage data. |
| GET | /v1/analytics/libraries/{file_key}/variable/actions | Get library analytics variable action data. |
| GET | /v1/analytics/libraries/{file_key}/variable/usages | Get library analytics variable usage data. |

### Oembed
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/oembed | Get oEmbed data |

## Common Questions
Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "Get file details?" -> GET /v1/files/{file_key}
- "List all nodes?" -> GET /v1/files/{file_key}/nodes
- "Get image details?" -> GET /v1/images/{file_key}
- "List all images?" -> GET /v1/files/{file_key}/images
- "List all meta?" -> GET /v1/files/{file_key}/meta
- "List all projects?" -> GET /v1/teams/{team_id}/projects
- "List all files?" -> GET /v1/projects/{project_id}/files
- "List all versions?" -> GET /v1/files/{file_key}/versions
- "List all comments?" -> GET /v1/files/{file_key}/comments
- "Create a comment?" -> POST /v1/files/{file_key}/comments
- "Delete a comment?" -> DELETE /v1/files/{file_key}/comments/{comment_id}
- "List all reactions?" -> GET /v1/files/{file_key}/comments/{comment_id}/reactions
- "Create a reaction?" -> POST /v1/files/{file_key}/comments/{comment_id}/reactions
- "List all me?" -> GET /v1/me
- "List all components?" -> GET /v1/teams/{team_id}/components
- "Get component details?" -> GET /v1/components/{key}
- "List all component_sets?" -> GET /v1/teams/{team_id}/component_sets
- "Get component_set details?" -> GET /v1/component_sets/{key}
- "List all styles?" -> GET /v1/teams/{team_id}/styles
- "Get style details?" -> GET /v1/styles/{key}
- "List all webhooks?" -> GET /v2/webhooks
- "Create a webhook?" -> POST /v2/webhooks
- "Get webhook details?" -> GET /v2/webhooks/{webhook_id}
- "Update a webhook?" -> PUT /v2/webhooks/{webhook_id}
- "Delete a webhook?" -> DELETE /v2/webhooks/{webhook_id}
- "List all requests?" -> GET /v2/webhooks/{webhook_id}/requests
- "List all activity_logs?" -> GET /v1/activity_logs
- "List all payments?" -> GET /v1/payments
- "List all local?" -> GET /v1/files/{file_key}/variables/local
- "List all published?" -> GET /v1/files/{file_key}/variables/published
- "Create a variable?" -> POST /v1/files/{file_key}/variables
- "List all dev_resources?" -> GET /v1/files/{file_key}/dev_resources
- "Create a dev_resource?" -> POST /v1/dev_resources
- "Delete a dev_resource?" -> DELETE /v1/files/{file_key}/dev_resources/{dev_resource_id}
- "List all actions?" -> GET /v1/analytics/libraries/{file_key}/component/actions
- "List all usages?" -> GET /v1/analytics/libraries/{file_key}/component/usages
- "List all oembed?" -> GET /v1/oembed
- "How to authenticate?" -> See Auth section above

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- Paginated endpoints accept limit/offset or cursor parameters
- Create/update endpoints return the modified resource on success
- Error responses include status codes and descriptions in the spec

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)