Actions43
- Comment Actions
- Component and Style Actions
- Dev Resource Actions
- Figma File Actions
- Library Analytic Actions
- Project Actions
- User Actions
- Variable Actions
- Version History Actions
- Webhook V2 Actions
Version History → Get File Versions
AI-generatedSummary
Retrieve the version history of a Figma file by specifying its file key and optional query parameters to filter or paginate the results.
Inputs
- Key (required) — The unique file key of the Figma file whose version history you want to fetch.
- Query Parameters — Optional parameters to refine the version history request such as pagination cursors, limit on number of versions returned, order, specific version id, date or time filters, and various other supported filters.
Output shape
a JSON object representing the list of versions and version metadata for the specified Figma file
The response includes metadata about file versions according to the Figma API's version history endpoint. Pagination and filtering can be controlled with the query parameters. Errors include missing required parameters such as 'Key'.
Examples
Example 1: Fetch the last 50 versions of a Figma file sorted ascending by timestamp.
Set 'Key' to the file's key and 'Limit' query parameter to 50, with default ordering (ascending).
Example 2: Retrieve a specific version by its ID.
Set 'Key' to the file's key and 'Version' query parameter to the specific version ID.