Figma icon

Figma

Use the Figma API

Library Analytic → List Variables Actions

AI-generated

Summary

Lists historical time series data about how variables within a design system library were used.

Inputs

  • Library File Key (required) — The key identifying the Figma library file from which to retrieve variable action analytics.
  • Query Parameters — Optional parameters to filter, paginate, and customize the analytics data returned (e.g., time range, pagination cursors, ordering, limits).

Output shape

a JSON object containing historical usage data of variables in the specified library file

Supports pagination and filtering via query parameters; the response format follows Figma's analytics endpoints. Requires a valid Library File Key; missing or invalid keys will result in errors.

Examples

Example 1: Retrieve the first 50 variable action events since a start date, ordered ascending.

Provide the Library File Key and set 'start_date', 'limit', and 'order' in Query Parameters.

Discussion