> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parable.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Figma REST API

> Figma is a collaborative design platform for building user interfaces, prototyping, and design systems. The Figma REST API provides access to files, projects, components, styles, comments, version history, webhooks, and team/organization management.

Figma is a collaborative design platform for building user interfaces, prototyping, and design systems. The Figma REST API provides access to files, projects, components, styles, comments, version history, webhooks, and team/organization management.

> [tab] Overview
>
> Connect Parable to Figma using either a Personal Access Token (PAT) or a Plan Access Token. Enter whichever you have in the same token field. Parable ingests design assets, version history, team structure, and (Enterprise, opt-in) activity logs.
>
> > **Info:** **Which token should I use?** A **Plan Access Token** is preferred for Organization/Enterprise plans: it is not tied to an individual user, supports up to a 1-year expiration, and can be scoped with a resource allowlist. A **Personal Access Token** is tied to the minting user and expires within 90 days. If you use a Plan Access Token, make sure its resource allowlist includes every team you configure in Parable.
>
> #### Design assets
>
> Projects, files, components, variables, and version history
>
> #### Activity & admin
>
> File comments and org-level activity logs (Enterprise, opt-in)
>
> ## Data streams
>
> This Provider Plugin defines 12 data streams.
>
> | Stream | Description | Sync |
> | - | - | - |
> | `team_projects` | Lists every folder (formerly project) of a Figma team, with its subfolders at every depth. Needs a Team ID in the connection form. Returns folder id, name, parent folder id, sharing audience control and creation time. | full |
> | `project_files` | Lists all files within a Figma folder (formerly project). Returns file key, name, thumbnail URL, and last modified timestamp. | full |
> | `file_versions` | Returns paginated version history for a Figma file. | full |
> | `file_comments` | Returns all comments on a Figma file. | full |
> | `team_components` | Lists all published components for a Figma team. Needs a Team ID in the connection form. | full |
> | `team_component_sets` | Lists all published component sets for a Figma team. Needs a Team ID in the connection form. | full |
> | `team_styles` | Lists all published styles for a Figma team. Needs a Team ID in the connection form. | full |
> | `file_components` | Lists all components within a specific Figma file. | full |
> | `file_styles` | Lists all styles within a specific Figma file. | full |
> | `comment_reactions` | Returns reactions on a specific comment in a Figma file. | full |
> | `file_dev_resources` | Returns dev resources attached to a Figma file. | full |
> | `activity_logs` | Retrieve organization activity log events from Figma. Returns timestamped events covering user and admin activity: file opens, edits, creation/deletion, comments, sharing changes, team membership changes, plugin usage, and administrative actions. Enterprise plan required. Organization admin must authorize. | incremental |

> [tab] Setup Guide
>
> ### Figma
>
> #### What You'll Need
>
> | Credential | What it is |
> | - | - |
> | **Personal Access Token** | Long-lived token minted from a user's Figma account settings |
> | **Plan Access Token** | Org/Enterprise token created by a plan admin, not tied to a user (recommended for org-wide automation) |
>
> > **Info:** **Service account required.** PATs are tied to the minting user -- if that user is removed from the team the token is revoked immediately and ingestion stops. Always mint from a **dedicated service-account user** on a **paid plan** (Professional, Organization, or Enterprise).
>
> * **`activity_logs`** is **disabled by default**. Enable it only if your organization is on the **Enterprise plan** with the service-account user having org admin access. A Figma organization that is not on the Enterprise plan gets `402 payment_required` on every sync.
>
> > **Info:** **Using a Plan Access Token instead?** Org/Enterprise admins can create one at [figma.com/developers/tokens](https://www.figma.com/developers/tokens) (requires 2FA). Choose the same scopes listed in Step 2, and on the **Choose resources** page either allow all resources or add every team you will sync in Parable. Then skip to Step 3 and paste it into the token field.
>
> #### Step 1: Open Figma Security settings
>
> 1. Sign in to Figma as the dedicated service-account user.
> 2. Click your avatar in the top-right and open **Settings**.
> 3. Switch to the **Security** tab.
> 4. Scroll to **Personal access tokens**.
>
> #### Step 2: Generate the token
>
> 1. Click **Generate new token**.
> 2. Set:
>    * **Token name** -- something traceable, e.g. `Parable`.
>    * **Expiration** -- choose the longest duration your security policy allows (`30 days`, `60 days`, `90 days`, `180 days`, or `No expiration`). Rotate at least every 12 months even if using no expiration.
>    * **Scopes** -- add the following:
>
> | Scope | Purpose |
> | - | - |
> | `folders:read` | Team folders (formerly projects) and the files in each folder |
> | `file_versions:read` | File version history |
> | `file_dev_resources:read` | Dev resources |
> | `file_comments:read` | File comments and reactions |
> | `team_library_content:read` | Team library components, component sets, and styles |
> | `library_content:read` | File-level library components and styles |
> | `org:activity_log_read` | Org activity logs (Enterprise only) |
>
> 3. Copy the token.
>
> > **Warning:** **Copy your Personal Access Token now!**
> >
> > This is the only time it will be displayed. Store it in a secure password manager before closing this page.
>
> #### Step 3: Enter values in the form
>
> 1. **Personal Access Token**: Paste the token from Figma.
> 2. **Team IDs** (optional): Add one row per Figma team you want to sync.
>    Find each team ID in the Figma URL: `figma.com/files/team/{team_id}/...`.
>    Leave the field empty to skip the data streams that need a Team ID.
> 3. Click **Save & test connection**.

> [tab] Permissions
>
> With **Enforce source permissions** on, Figma data requires
> [All data access](https://docs.parable.work/protection/provider-policies.md#all-data-access) unless a
> Provider Policy grants access. The connector does not ingest the membership
> and sharing facts needed to identify each file's readers. Authors and
> activity actors receive no source grant. To share this data, set an explicit
> [Provider Policy](https://docs.parable.work/protection/provider-policies.md).
>
> > [accordion] Activity Logs
> >
> > Developer identifier: `activity_logs`
> >
> > Activity Logs contain organization activity log events from Figma. Returns timestamped events covering user and admin activity: file opens, edits, creation/deletion, comments, sharing changes, team membership changes, plugin usage, and administrative actions. Enterprise plan required. Organization admin must authorize.
> >
> > * **Enables:** trace organization events such as file changes, sharing changes, and membership administration to recorded actors and times.
> >
> > * **Scope:** Reads the records that changed since the previous sync from `GET /v1/activity_logs`. This Enterprise-only operation requires organization-administrator authorization; events outside the returned organization log are absent.
> >
> > > [accordion] Action
> > >
> > > Developer identifier: `activity_logs.action`
> > >
> > > Action captures the action taken, including its type and event-specific details. It preserves the provider's current classification of this record.
> > >
> > > * **Enables:** separate activity log records by the exact provider-reported action value when describing their recorded state.
> > > * **Interpretation:** The provider supplies `action` per activity log event record using its own state vocabulary; unknown and missing values must remain distinct.
> >
> > > [accordion] Details
> > >
> > > Developer identifier: `activity_logs.action.details`
> > >
> > > Details records action-specific details that vary by action type. It holds configured attributes whose keys and shapes can vary.
> > >
> > > * **Enables:** interpret details according to the provider and Workspace configuration that produced each activity log record.
> > > * **Interpretation:** Keys and value shapes within `details` can vary with provider and customer configuration. Check the keys in your Workspace's data rather than assume a fixed set.
> >
> > > [accordion] Type
> > >
> > > Developer identifier: `activity_logs.action.type`
> > >
> > > Type states action type (e.g., `file_view`, `file_edit`, `comment_add`, `team_member_add`, `admin_settings_change`). It preserves the provider's current classification of this record.
> > >
> > > * **Enables:** separate activity log records by the exact provider-reported type value when describing their recorded state.
> > > * **Interpretation:** The provider supplies `type` per activity action record using its own state vocabulary; unknown and missing values must remain distinct.
> >
> > > [accordion] Actor
> > >
> > > Developer identifier: `activity_logs.actor`
> > >
> > > Actor captures the user who performed the action. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the activity log event record to the provider-reported actor represented by actor.
> > > * **Interpretation:** The provider supplies `actor` as identity or attribution context on each activity log event record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] Email
> > >
> > > Developer identifier: `activity_logs.actor.email`
> > >
> > > Email records email address of the actor. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the activity actor record to the provider-reported person or account represented by email.
> > > * **Interpretation:** The provider supplies `email` as identity or attribution context on each activity actor record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] ID
> > >
> > > Developer identifier: `activity_logs.actor.id`
> > >
> > > ID is the unique identifier of the actor. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match activity log records to provider records that carry the same ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Name
> > >
> > > Developer identifier: `activity_logs.actor.name`
> > >
> > > Name records display name of the actor. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the activity actor record to the provider-reported person or account represented by name.
> > > * **Interpretation:** The provider supplies `name` as identity or attribution context on each activity actor record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] Type
> > >
> > > Developer identifier: `activity_logs.actor.type`
> > >
> > > Type states type of the actor (e.g., user, `service_account`). It preserves the provider's current classification of this record.
> > >
> > > * **Enables:** separate activity log records by the exact provider-reported type value when describing their recorded state.
> > > * **Interpretation:** The provider supplies `type` per activity actor record using its own state vocabulary; unknown and missing values must remain distinct.
> >
> > > [accordion] Context
> > >
> > > Developer identifier: `activity_logs.context`
> > >
> > > Context records client and network context in which the action occurred. It preserves the containing or referenced object needed to reconstruct the provider relationship.
> > >
> > > * **Enables:** expand the nested context object into its declared child fields for each activity log event record.
> > > * **Interpretation:** The provider returns `context` as a nested object or reference; an absent value does not prove that no related object exists outside the credential's visibility.
> >
> > > [accordion] Client Name
> > >
> > > Developer identifier: `activity_logs.context.client_name`
> > >
> > > Client Name records name of the client from which the action was performed (e.g., `figma_web`, `figma_desktop`). It preserves the client environment reported with the event.
> > >
> > > * **Enables:** count Figma activity log events by the reported client name.
> > > * **Interpretation:** Figma supplies `client_name` per activity log event from client metadata; missing values do not identify an operating system or browser.
> >
> > > [accordion] IP Address
> > >
> > > Developer identifier: `activity_logs.context.ip_address`
> > >
> > > IP Address records IP address from which the action was performed. It preserves the geographic, locale, time-zone, or coordinate context represented by the field.
> > >
> > > * **Enables:** segment activity log records by the recorded IP address without inferring a person's physical presence.
> > > * **Interpretation:** The provider supplies `ip_address` as location or localization context per activity context record; it does not establish a person's real-time physical location.
> >
> > > [accordion] Is Figma Support Team Action
> > >
> > > Developer identifier: `activity_logs.context.is_figma_support_team_action`
> > >
> > > Is Figma Support Team Action indicates whether the action was performed by the Figma support team. It preserves the provider-reported yes-or-no condition for this record.
> > >
> > > * **Enables:** select activity log records for which the provider reports is figma support team action as true or false.
> > > * **Interpretation:** The provider supplies `is_figma_support_team_action` as a boolean per activity context record; false and missing are distinct when the field is optional.
> >
> > > [accordion] Entity
> > >
> > > Developer identifier: `activity_logs.entity`
> > >
> > > Entity captures the primary entity (file, project, team, etc.) that was acted upon. It preserves the containing or referenced object needed to reconstruct the provider relationship.
> > >
> > > * **Enables:** associate each activity log event record with the specific provider container named by entity.
> > > * **Interpretation:** The provider returns `entity` as a nested object or reference; an absent value does not prove that no related object exists outside the credential's visibility.
> >
> > > [accordion] Key
> > >
> > > Developer identifier: `activity_logs.entity.key`
> > >
> > > Key is the unique key of the entity. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match activity log records to provider records that carry the same key, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `key` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Name
> > >
> > > Developer identifier: `activity_logs.entity.name`
> > >
> > > Name records display name of the entity. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact name returned for each Figma activity log record.
> > > * **Interpretation:** The value covers only the activity logs content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Type
> > >
> > > Developer identifier: `activity_logs.entity.type`
> > >
> > > Type states type of the entity (e.g., file, project, team, org). It preserves the provider's current classification of this record.
> > >
> > > * **Enables:** separate activity log records by the exact provider-reported type value when describing their recorded state.
> > > * **Interpretation:** The provider supplies `type` per activity entity record using its own state vocabulary; unknown and missing values must remain distinct.
> >
> > > [accordion] ID
> > >
> > > Developer identifier: `activity_logs.id`
> > >
> > > ID is the unique identifier for the activity log event. It is the record key, so rows with the same value describe the same record.
> > >
> > > * **Enables:** identify each activity log event record across syncs.
> > > * **Interpretation:** The provider supplies `id` at one value per activity log event record, and it is the record key.
> >
> > > [accordion] Timestamp
> > >
> > > Developer identifier: `activity_logs.timestamp`
> > >
> > > Timestamp records unix epoch seconds when the event occurred. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place activity log records on a timeline by timestamp and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `timestamp` per activity log event record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
>
> > [accordion] Comment Reactions
> >
> > Developer identifier: `comment_reactions`
> >
> > Comment Reactions contain reactions on a specific comment in a Figma file. Parable reads them for each comment that has reactions.
> >
> > * **Enables:** count and attribute the reactions recorded on a specific file comment.
> >
> > * **Scope:** Reads every record from `GET /v1/files/{file_key}/comments/{id}/reactions` on each sync. Results are limited by the token's granted scopes and team resource allowlist; inaccessible files and teams are absent.
> >
> > > [accordion] Comment ID
> > >
> > > Developer identifier: `comment_reactions.comment_id`
> > >
> > > Comment ID identifies the id of the parent record in `file_comments`, and Parable copies it from that record. Figma does not return this value with the record. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match comment reaction records to provider records that carry the same comment ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `comment_id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Created At
> > >
> > > Developer identifier: `comment_reactions.created_at`
> > >
> > > Created At records ISO 8601 timestamp indicating when the reaction was created. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place comment reaction records on a timeline by created at and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `created_at` per comment reaction record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
> >
> > > [accordion] Emoji
> > >
> > > Developer identifier: `comment_reactions.emoji`
> > >
> > > Emoji captures the emoji shortcode representing the reaction. It preserves the provider's visual treatment for the represented object.
> > >
> > > * **Enables:** reproduce or compare the provider-supplied emoji for the represented design or board object.
> > > * **Interpretation:** The provider supplies `emoji` in its own color, opacity, stroke, emoji, or style vocabulary for the represented object.
> >
> > > [accordion] File Key
> > >
> > > Developer identifier: `comment_reactions.file_key`
> > >
> > > File Key identifies the `file_key` of the parent record in `file_comments`, and Parable copies it from that record. Figma does not return this value with the record. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match comment reaction records to provider records that carry the same file key, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `file_key` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] ID
> > >
> > > Developer identifier: `comment_reactions.id`
> > >
> > > Parable builds this key from `file_key`, `comment_id`, `emoji`, and `user.id` to identify a reaction. Two people using the same emoji on the same comment remain separate rows. Repeated reads of the same person's reaction keep the same key.
> >
> > > [accordion] User
> > >
> > > Developer identifier: `comment_reactions.user`
> > >
> > > User captures the user who posted this reaction on the comment. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the comment reaction record to the provider-reported actor represented by user.
> > > * **Interpretation:** The provider supplies `user` as identity or attribution context on each comment reaction record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] Handle
> > >
> > > Developer identifier: `comment_reactions.user.handle`
> > >
> > > Handle records display name (handle) of the user. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the reaction user record to the provider-reported person or account represented by handle.
> > > * **Interpretation:** The provider supplies `handle` as identity or attribution context on each reaction user record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] ID
> > >
> > > Developer identifier: `comment_reactions.user.id`
> > >
> > > ID is the unique identifier for the Figma user. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match comment reaction records to provider records that carry the same ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Img URL
> > >
> > > Developer identifier: `comment_reactions.user.img_url`
> > >
> > > Img URL records URL to the user's profile image/avatar. It retains the exact provider location for the referenced resource.
> > >
> > > * **Enables:** open or trace the exact provider resource referenced by img URL on a reaction user record.
> > > * **Interpretation:** The provider supplies `img_url` as a URL or resource locator on each reaction user record. Availability still follows the provider's permissions and retention.
>
> > [accordion] File Comments
> >
> > Developer identifier: `file_comments`
> >
> > File Comments contain all comments on a Figma file. Parable reads them for each Figma file it reads.
> >
> > * **Enables:** review comment text and authorship attached to each design file.
> >
> > * **Scope:** Reads every record from `GET /v1/files/{key}/comments` on each sync. Results are limited by the token's granted scopes and team resource allowlist; inaccessible files and teams are absent.
> >
> > > [accordion] Client Meta
> > >
> > > Developer identifier: `file_comments.client_meta`
> > >
> > > Client Meta records positional metadata indicating where the comment was placed on the canvas or within a frame. It preserves the geographic, locale, time-zone, or coordinate context represented by the field.
> > >
> > > * **Enables:** place the represented design or board object using its provider canvas client meta.
> > > * **Interpretation:** The provider supplies `client_meta` in its canvas coordinate system for this object; it is not a geographic coordinate.
> >
> > > [accordion] Node ID
> > >
> > > Developer identifier: `file_comments.client_meta.node_id`
> > >
> > > Node ID captures the node ID the comment is pinned to, if applicable. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file comment records to provider records that carry the same node ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `node_id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Node Offset
> > >
> > > Developer identifier: `file_comments.client_meta.node_offset`
> > >
> > > Node Offset records offset from the node origin where the comment is pinned. It preserves the geographic, locale, time-zone, or coordinate context represented by the field.
> > >
> > > * **Enables:** place the represented design or board object using its provider canvas node offset.
> > > * **Interpretation:** The provider supplies `node_offset` in its canvas coordinate system for this object; it is not a geographic coordinate.
> >
> > > [accordion] X Coordinate
> > >
> > > Developer identifier: `file_comments.client_meta.node_offset.x`
> > >
> > > X Coordinate records x component. It preserves the geographic, locale, time-zone, or coordinate context represented by the field.
> > >
> > > * **Enables:** place the represented design or board object using its provider canvas x coordinate.
> > > * **Interpretation:** The provider supplies `x` in its canvas coordinate system for this object; it is not a geographic coordinate.
> >
> > > [accordion] Y Coordinate
> > >
> > > Developer identifier: `file_comments.client_meta.node_offset.y`
> > >
> > > Y Coordinate records y component. It preserves the geographic, locale, time-zone, or coordinate context represented by the field.
> > >
> > > * **Enables:** place the represented design or board object using its provider canvas y coordinate.
> > > * **Interpretation:** The provider supplies `y` in its canvas coordinate system for this object; it is not a geographic coordinate.
> >
> > > [accordion] X Coordinate
> > >
> > > Developer identifier: `file_comments.client_meta.x`
> > >
> > > X Coordinate records x coordinate of the comment pin. It preserves the geographic, locale, time-zone, or coordinate context represented by the field.
> > >
> > > * **Enables:** place the represented design or board object using its provider canvas x coordinate.
> > > * **Interpretation:** The provider supplies `x` in its canvas coordinate system for this object; it is not a geographic coordinate.
> >
> > > [accordion] Y Coordinate
> > >
> > > Developer identifier: `file_comments.client_meta.y`
> > >
> > > Y Coordinate records y coordinate of the comment pin. It preserves the geographic, locale, time-zone, or coordinate context represented by the field.
> > >
> > > * **Enables:** place the represented design or board object using its provider canvas y coordinate.
> > > * **Interpretation:** The provider supplies `y` in its canvas coordinate system for this object; it is not a geographic coordinate.
> >
> > > [accordion] Created At
> > >
> > > Developer identifier: `file_comments.created_at`
> > >
> > > Created At records ISO 8601 timestamp when the comment was created. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place file comment records on a timeline by created at and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `created_at` per file comment record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
> >
> > > [accordion] File Key
> > >
> > > Developer identifier: `file_comments.file_key`
> > >
> > > File Key captures the key of the Figma file this comment belongs to. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file comment records to provider records that carry the same file key, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `file_key` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] ID
> > >
> > > Developer identifier: `file_comments.id`
> > >
> > > ID is the unique identifier for the comment. It is the record key, so rows with the same value describe the same record.
> > >
> > > * **Enables:** identify each file comment record across syncs.
> > > * **Interpretation:** The provider supplies `id` at one value per file comment record, and it is the record key.
> >
> > > [accordion] Message
> > >
> > > Developer identifier: `file_comments.message`
> > >
> > > Message captures the comment message text. Returned as markdown when `as_md`=true. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact message returned for each Figma file comment record.
> > > * **Interpretation:** The value covers only the file comments content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Order ID
> > >
> > > Developer identifier: `file_comments.order_id`
> > >
> > > Order ID contains an ordering identifier used to sort comments chronologically. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file comment records to provider records that carry the same order ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `order_id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Parent ID
> > >
> > > Developer identifier: `file_comments.parent_id`
> > >
> > > Parent ID captures the ID of the parent comment if this comment is a reply. Empty string if top-level. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file comment records to provider records that carry the same parent ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `parent_id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Resolved At
> > >
> > > Developer identifier: `file_comments.resolved_at`
> > >
> > > Resolved At records ISO 8601 timestamp when the comment was resolved. Null if unresolved. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place file comment records on a timeline by resolved at and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `resolved_at` per file comment record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
> >
> > > [accordion] User
> > >
> > > Developer identifier: `file_comments.user`
> > >
> > > User captures the user who posted the comment. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the file comment record to the provider-reported actor represented by user.
> > > * **Interpretation:** The provider supplies `user` as identity or attribution context on each file comment record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] Handle
> > >
> > > Developer identifier: `file_comments.user.handle`
> > >
> > > Handle records display name / handle of the user. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the comment user record to the provider-reported person or account represented by handle.
> > > * **Interpretation:** The provider supplies `handle` as identity or attribution context on each comment user record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] ID
> > >
> > > Developer identifier: `file_comments.user.id`
> > >
> > > ID is the unique user identifier. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file comment records to provider records that carry the same ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Img URL
> > >
> > > Developer identifier: `file_comments.user.img_url`
> > >
> > > Img URL records URL of the user's profile image. It retains the exact provider location for the referenced resource.
> > >
> > > * **Enables:** open or trace the exact provider resource referenced by img URL on a comment user record.
> > > * **Interpretation:** The provider supplies `img_url` as a URL or resource locator on each comment user record. Availability still follows the provider's permissions and retention.
>
> > [accordion] File Components
> >
> > Developer identifier: `file_components`
> >
> > File Components contain all components within a specific Figma file. Parable reads them for each Figma file it reads.
> >
> > * **Enables:** inspect component definitions local to a specific design file.
> >
> > * **Scope:** Reads every record from `GET /v1/files/{key}/components` on each sync. Results are limited by the token's granted scopes and team resource allowlist; inaccessible files and teams are absent.
> >
> > > [accordion] Component Set ID
> > >
> > > Developer identifier: `file_components.component_set_id`
> > >
> > > Component Set ID identifies if this component is part of a component set (variants), this is the key of the parent component set. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file component records to provider records that carry the same component set ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `component_set_id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Component Set Name
> > >
> > > Developer identifier: `file_components.component_set_name`
> > >
> > > Component Set Name captures the name of the parent component set, if applicable. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact component set name returned for each Figma file component record.
> > > * **Interpretation:** The value covers only the file components content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Containing Frame
> > >
> > > Developer identifier: `file_components.containing_frame`
> > >
> > > Containing Frame records information about the frame that contains this component in the file. It preserves the containing or referenced object needed to reconstruct the provider relationship.
> > >
> > > * **Enables:** expand the nested containing frame object into its declared child fields for each file component record.
> > > * **Interpretation:** The provider returns `containing_frame` as a nested object or reference; an absent value does not prove that no related object exists outside the credential's visibility.
> >
> > > [accordion] Background Color
> > >
> > > Developer identifier: `file_components.containing_frame.backgroundColor`
> > >
> > > Background Color records background color of the containing frame. It preserves the provider's visual treatment for the represented object.
> > >
> > > * **Enables:** reproduce or compare the provider-supplied background color for the represented design or board object.
> > > * **Interpretation:** The provider supplies `backgroundColor` in its own color, opacity, stroke, emoji, or style vocabulary for the represented object.
> >
> > > [accordion] Containing State Group
> > >
> > > Developer identifier: `file_components.containing_frame.containingStateGroup`
> > >
> > > Containing State Group states if the component is inside a state group, information about that group. It preserves the provider's current classification of this record.
> > >
> > > * **Enables:** separate file component records by the exact provider-reported containing state group value when describing their recorded state.
> > > * **Interpretation:** The provider supplies `containingStateGroup` per containing frame record using its own state vocabulary; unknown and missing values must remain distinct.
> >
> > > [accordion] Name
> > >
> > > Developer identifier: `file_components.containing_frame.containingStateGroup.name`
> > >
> > > Name captures the name of the state group. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact name returned for each Figma file component record.
> > > * **Interpretation:** The value covers only the file components content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Node ID
> > >
> > > Developer identifier: `file_components.containing_frame.containingStateGroup.nodeId`
> > >
> > > Node ID captures the node ID of the state group. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file component records to provider records that carry the same node ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `nodeId` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Name
> > >
> > > Developer identifier: `file_components.containing_frame.name`
> > >
> > > Name captures the name of the containing frame. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact name returned for each Figma file component record.
> > > * **Interpretation:** The value covers only the file components content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Node ID
> > >
> > > Developer identifier: `file_components.containing_frame.nodeId`
> > >
> > > Node ID captures the node ID of the containing frame. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file component records to provider records that carry the same node ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `nodeId` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Page ID
> > >
> > > Developer identifier: `file_components.containing_frame.pageId`
> > >
> > > Page ID captures the node ID of the page that contains this frame. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file component records to provider records that carry the same page ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `pageId` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Page Name
> > >
> > > Developer identifier: `file_components.containing_frame.pageName`
> > >
> > > Page Name captures the name of the page that contains this frame. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact page name returned for each Figma file component record.
> > > * **Interpretation:** The value covers only the file components content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Created At
> > >
> > > Developer identifier: `file_components.created_at`
> > >
> > > Created At records ISO 8601 timestamp indicating when the component was first created. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place file component records on a timeline by created at and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `created_at` per file component record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
> >
> > > [accordion] Description
> > >
> > > Developer identifier: `file_components.description`
> > >
> > > Description contains a human-readable description of the component. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact description returned for each Figma file component record.
> > > * **Interpretation:** The value covers only the file components content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] File Key
> > >
> > > Developer identifier: `file_components.file_key`
> > >
> > > File Key captures the key of the Figma file containing this component. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file component records to provider records that carry the same file key, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `file_key` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Key
> > >
> > > Developer identifier: `file_components.key`
> > >
> > > Key is the unique component key that globally identifies this component. It is the record key, so rows with the same value describe the same record.
> > >
> > > * **Enables:** identify each file component record across syncs.
> > > * **Interpretation:** The provider supplies `key` at one value per file component record, and it is the record key.
> >
> > > [accordion] Name
> > >
> > > Developer identifier: `file_components.name`
> > >
> > > Name captures the name of the component as displayed in Figma. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact name returned for each Figma file component record.
> > > * **Interpretation:** The value covers only the file components content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Node ID
> > >
> > > Developer identifier: `file_components.node_id`
> > >
> > > Node ID captures the node ID of this component within the file's document tree. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file component records to provider records that carry the same node ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `node_id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Thumbnail URL
> > >
> > > Developer identifier: `file_components.thumbnail_url`
> > >
> > > Thumbnail URL records URL to a thumbnail image of the component. It retains the exact provider location for the referenced resource.
> > >
> > > * **Enables:** open or trace the exact provider resource referenced by thumbnail URL on a file component record.
> > > * **Interpretation:** The provider supplies `thumbnail_url` as a URL or resource locator on each file component record. Availability still follows the provider's permissions and retention.
> >
> > > [accordion] Updated At
> > >
> > > Developer identifier: `file_components.updated_at`
> > >
> > > Updated At records ISO 8601 timestamp indicating when the component was last updated. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place file component records on a timeline by updated at and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `updated_at` per file component record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
> >
> > > [accordion] User
> > >
> > > Developer identifier: `file_components.user`
> > >
> > > User captures the user who last modified or published this component. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the file component record to the provider-reported actor represented by user.
> > > * **Interpretation:** The provider supplies `user` as identity or attribution context on each file component record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] Handle
> > >
> > > Developer identifier: `file_components.user.handle`
> > >
> > > Handle records display name (handle) of the user. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the user record to the provider-reported person or account represented by handle.
> > > * **Interpretation:** The provider supplies `handle` as identity or attribution context on each user record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] ID
> > >
> > > Developer identifier: `file_components.user.id`
> > >
> > > ID is the unique identifier for the Figma user. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file component records to provider records that carry the same ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Img URL
> > >
> > > Developer identifier: `file_components.user.img_url`
> > >
> > > Img URL records URL to the user's profile image. It retains the exact provider location for the referenced resource.
> > >
> > > * **Enables:** open or trace the exact provider resource referenced by img URL on a user record.
> > > * **Interpretation:** The provider supplies `img_url` as a URL or resource locator on each user record. Availability still follows the provider's permissions and retention.
>
> > [accordion] File Dev Resources
> >
> > Developer identifier: `file_dev_resources`
> >
> > File Dev Resources contain dev resources attached to a Figma file. Parable reads them for each Figma file it reads.
> >
> > * **Enables:** trace developer-resource links attached to nodes in a specific file.
> >
> > * **Scope:** Reads every record from `GET /v1/files/{key}/dev_resources` on each sync. Results are limited by the token's granted scopes and team resource allowlist; inaccessible files and teams are absent.
> >
> > > [accordion] Created At
> > >
> > > Developer identifier: `file_dev_resources.created_at`
> > >
> > > Created At records ISO 8601 timestamp of when the dev resource was created. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place file dev resource records on a timeline by created at and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `created_at` per dev resource record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
> >
> > > [accordion] Created By
> > >
> > > Developer identifier: `file_dev_resources.created_by`
> > >
> > > Created By captures the user who created this dev resource. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the dev resource record to the provider-reported person or account represented by created by.
> > > * **Interpretation:** The provider supplies `created_by` as identity or attribution context on each dev resource record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] Handle
> > >
> > > Developer identifier: `file_dev_resources.created_by.handle`
> > >
> > > Handle records display name / handle of the user. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the user record to the provider-reported person or account represented by handle.
> > > * **Interpretation:** The provider supplies `handle` as identity or attribution context on each user record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] ID
> > >
> > > Developer identifier: `file_dev_resources.created_by.id`
> > >
> > > ID is the unique user identifier. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file dev resource records to provider records that carry the same ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Img URL
> > >
> > > Developer identifier: `file_dev_resources.created_by.img_url`
> > >
> > > Img URL records URL of the user's profile image. It retains the exact provider location for the referenced resource.
> > >
> > > * **Enables:** open or trace the exact provider resource referenced by img URL on a user record.
> > > * **Interpretation:** The provider supplies `img_url` as a URL or resource locator on each user record. Availability still follows the provider's permissions and retention.
> >
> > > [accordion] Dev Resource Type
> > >
> > > Developer identifier: `file_dev_resources.dev_resource_type`
> > >
> > > Dev Resource Type captures the type/category of the dev resource. It preserves the provider's current classification of this record.
> > >
> > > * **Enables:** separate file dev resource records by the exact provider-reported dev resource type value when describing their recorded state.
> > > * **Interpretation:** The provider supplies `dev_resource_type` per dev resource record using its own state vocabulary; unknown and missing values must remain distinct.
> >
> > > [accordion] File Key
> > >
> > > Developer identifier: `file_dev_resources.file_key`
> > >
> > > File Key captures the key of the Figma file this dev resource belongs to. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file dev resource records to provider records that carry the same file key, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `file_key` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] ID
> > >
> > > Developer identifier: `file_dev_resources.id`
> > >
> > > ID is the unique identifier for the dev resource. It is the record key, so rows with the same value describe the same record.
> > >
> > > * **Enables:** identify each dev resource record across syncs.
> > > * **Interpretation:** The provider supplies `id` at one value per dev resource record, and it is the record key.
> >
> > > [accordion] Inherited From
> > >
> > > Developer identifier: `file_dev_resources.inherited_from`
> > >
> > > Inherited From identifies the component or instance from which the development resource inherits. It preserves the source relationship needed to explain inherited resource metadata.
> > >
> > > * **Enables:** follow the inheritance link back to its source component or instance and distinguish inherited resources from directly defined ones.
> > > * **Interpretation:** The provider returns `inherited_from` as a nested source reference; absence means no inheritance source was reported on that resource.
> >
> > > [accordion] File Key
> > >
> > > Developer identifier: `file_dev_resources.inherited_from.file_key`
> > >
> > > File Key captures the file key of the source file from which the dev resource was inherited. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file dev resource records to provider records that carry the same file key, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `file_key` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Node ID
> > >
> > > Developer identifier: `file_dev_resources.inherited_from.node_id`
> > >
> > > Node ID captures the node ID in the source file from which the dev resource was inherited. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file dev resource records to provider records that carry the same node ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `node_id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Name
> > >
> > > Developer identifier: `file_dev_resources.name`
> > >
> > > Name records display name of the dev resource. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact name returned for each Figma file dev resource record.
> > > * **Interpretation:** The value covers only the file dev resources content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Node ID
> > >
> > > Developer identifier: `file_dev_resources.node_id`
> > >
> > > Node ID captures the ID of the node within the file that this dev resource is attached to. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file dev resource records to provider records that carry the same node ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `node_id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Updated At
> > >
> > > Developer identifier: `file_dev_resources.updated_at`
> > >
> > > Updated At records ISO 8601 timestamp of when the dev resource was last updated. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place file dev resource records on a timeline by updated at and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `updated_at` per dev resource record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
> >
> > > [accordion] URL
> > >
> > > Developer identifier: `file_dev_resources.url`
> > >
> > > URL records URL of the external dev resource. It retains the exact provider location for the referenced resource.
> > >
> > > * **Enables:** open or trace the exact provider resource referenced by URL on a dev resource record.
> > > * **Interpretation:** The provider supplies `url` as a URL or resource locator on each dev resource record. Availability still follows the provider's permissions and retention.
>
> > [accordion] File Styles
> >
> > Developer identifier: `file_styles`
> >
> > File Styles contain all styles within a specific Figma file. Parable reads them for each Figma file it reads.
> >
> > * **Enables:** inspect style definitions local to a specific design file.
> >
> > * **Scope:** Reads every record from `GET /v1/files/{key}/styles` on each sync. Results are limited by the token's granted scopes and team resource allowlist; inaccessible files and teams are absent.
> >
> > > [accordion] Created At
> > >
> > > Developer identifier: `file_styles.created_at`
> > >
> > > Created At records ISO 8601 timestamp indicating when the style was created. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place file style records on a timeline by created at and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `created_at` per figma file style record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
> >
> > > [accordion] Description
> > >
> > > Developer identifier: `file_styles.description`
> > >
> > > Description records description of the style provided by the designer. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact description returned for each Figma file style record.
> > > * **Interpretation:** The value covers only the file styles content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] File Key
> > >
> > > Developer identifier: `file_styles.file_key`
> > >
> > > File Key captures the key of the Figma file that contains this style. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file style records to provider records that carry the same file key, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `file_key` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Key
> > >
> > > Developer identifier: `file_styles.key`
> > >
> > > Key is the unique identifier key for the style. It is the record key, so rows with the same value describe the same record.
> > >
> > > * **Enables:** identify each figma file style record across syncs.
> > > * **Interpretation:** The provider supplies `key` at one value per figma file style record, and it is the record key.
> >
> > > [accordion] Name
> > >
> > > Developer identifier: `file_styles.name`
> > >
> > > Name records human-readable name of the style. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact name returned for each Figma file style record.
> > > * **Interpretation:** The value covers only the file styles content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Node ID
> > >
> > > Developer identifier: `file_styles.node_id`
> > >
> > > Node ID captures the node ID within the file where this style is defined. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file style records to provider records that carry the same node ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `node_id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Sort Position
> > >
> > > Developer identifier: `file_styles.sort_position`
> > >
> > > Sort Position contains a string used for sorting the style within its category or file. It preserves the stated measure at this record's granularity.
> > >
> > > * **Enables:** order or classify file style records using the provider-defined sort position value.
> > > * **Interpretation:** The provider supplies `sort_position` at figma file style granularity as a provider-defined ordinal or planning value rather than elapsed time or money; zero and missing are not interchangeable.
> >
> > > [accordion] Style Type
> > >
> > > Developer identifier: `file_styles.style_type`
> > >
> > > Style Type captures the type of style (e.g., FILL, TEXT, EFFECT, GRID). It preserves the provider's current classification of this record.
> > >
> > > * **Enables:** separate file style records by the exact provider-reported style type value when describing their recorded state.
> > > * **Interpretation:** The provider supplies `style_type` per figma file style record using its own state vocabulary; unknown and missing values must remain distinct.
> >
> > > [accordion] Thumbnail URL
> > >
> > > Developer identifier: `file_styles.thumbnail_url`
> > >
> > > Thumbnail URL records URL to a thumbnail image representing the style. It retains the exact provider location for the referenced resource.
> > >
> > > * **Enables:** open or trace the exact provider resource referenced by thumbnail URL on a figma file style record.
> > > * **Interpretation:** The provider supplies `thumbnail_url` as a URL or resource locator on each figma file style record. Availability still follows the provider's permissions and retention.
> >
> > > [accordion] Updated At
> > >
> > > Developer identifier: `file_styles.updated_at`
> > >
> > > Updated At records ISO 8601 timestamp indicating when the style was last updated. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place file style records on a timeline by updated at and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `updated_at` per figma file style record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
> >
> > > [accordion] User
> > >
> > > Developer identifier: `file_styles.user`
> > >
> > > User captures the user who last modified or published the style. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the figma file style record to the provider-reported actor represented by user.
> > > * **Interpretation:** The provider supplies `user` as identity or attribution context on each figma file style record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] Handle
> > >
> > > Developer identifier: `file_styles.user.handle`
> > >
> > > Handle records display name (handle) of the user. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the figma user record to the provider-reported person or account represented by handle.
> > > * **Interpretation:** The provider supplies `handle` as identity or attribution context on each figma user record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] ID
> > >
> > > Developer identifier: `file_styles.user.id`
> > >
> > > ID is the unique identifier of the Figma user. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file style records to provider records that carry the same ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Img URL
> > >
> > > Developer identifier: `file_styles.user.img_url`
> > >
> > > Img URL records URL to the user's profile image. It retains the exact provider location for the referenced resource.
> > >
> > > * **Enables:** open or trace the exact provider resource referenced by img URL on a figma user record.
> > > * **Interpretation:** The provider supplies `img_url` as a URL or resource locator on each figma user record. Availability still follows the provider's permissions and retention.
>
> > [accordion] File Versions
> >
> > Developer identifier: `file_versions`
> >
> > File Versions contain the version history of a Figma file. Parable reads it for each Figma file it reads.
> >
> > * **Enables:** reconstruct the version history returned for each design file.
> >
> > * **Scope:** Reads every record from `GET /v1/files/{key}/versions` on each sync. Results are limited by the token's granted scopes and team resource allowlist; inaccessible files and teams are absent.
> >
> > > [accordion] Created At
> > >
> > > Developer identifier: `file_versions.created_at`
> > >
> > > Created At records ISO 8601 timestamp indicating when this version was created. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place file version records on a timeline by created at and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `created_at` per file version record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
> >
> > > [accordion] Description
> > >
> > > Developer identifier: `file_versions.description`
> > >
> > > Description records user-provided description for this version. May be empty if no description was set. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact description returned for each Figma file version record.
> > > * **Interpretation:** The value covers only the file versions content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] File Key
> > >
> > > Developer identifier: `file_versions.file_key`
> > >
> > > File Key identifies the key of the parent record in `project_files`, and Parable copies it from that record. Figma does not return this value with the record. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file version records to provider records that carry the same file key, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `file_key` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] ID
> > >
> > > Developer identifier: `file_versions.id`
> > >
> > > ID is the unique identifier for this file version. It is the record key, so rows with the same value describe the same record.
> > >
> > > * **Enables:** identify each file version record across syncs.
> > > * **Interpretation:** The provider supplies `id` at one value per file version record, and it is the record key.
> >
> > > [accordion] Label
> > >
> > > Developer identifier: `file_versions.label`
> > >
> > > Label records user-assigned label or name for this version. May be empty if no label was set. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact label returned for each Figma file version record.
> > > * **Interpretation:** The value covers only the file versions content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Thumbnail URL
> > >
> > > Developer identifier: `file_versions.thumbnail_url`
> > >
> > > Thumbnail URL records URL to a thumbnail image representing the file at this version. It retains the exact provider location for the referenced resource.
> > >
> > > * **Enables:** open or trace the exact provider resource referenced by thumbnail URL on a file version record.
> > > * **Interpretation:** The provider supplies `thumbnail_url` as a URL or resource locator on each file version record. Availability still follows the provider's permissions and retention.
> >
> > > [accordion] User
> > >
> > > Developer identifier: `file_versions.user`
> > >
> > > User captures the user who created or saved this version. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the file version record to the provider-reported actor represented by user.
> > > * **Interpretation:** The provider supplies `user` as identity or attribution context on each file version record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] Email
> > >
> > > Developer identifier: `file_versions.user.email`
> > >
> > > Email records email address of the user. Typically only populated on the /v1/me endpoint; may be absent here. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the user record to the provider-reported person or account represented by email.
> > > * **Interpretation:** The provider supplies `email` as identity or attribution context on each user record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] Handle
> > >
> > > Developer identifier: `file_versions.user.handle`
> > >
> > > Handle records display name or handle of the user. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the user record to the provider-reported person or account represented by handle.
> > > * **Interpretation:** The provider supplies `handle` as identity or attribution context on each user record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] ID
> > >
> > > Developer identifier: `file_versions.user.id`
> > >
> > > ID is the unique identifier for the Figma user. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match file version records to provider records that carry the same ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Img URL
> > >
> > > Developer identifier: `file_versions.user.img_url`
> > >
> > > Img URL records URL to the user's profile avatar image. It retains the exact provider location for the referenced resource.
> > >
> > > * **Enables:** open or trace the exact provider resource referenced by img URL on a user record.
> > > * **Interpretation:** The provider supplies `img_url` as a URL or resource locator on each user record. Availability still follows the provider's permissions and retention.
>
> > [accordion] Project Files
> >
> > Developer identifier: `project_files`
> >
> > Project Files contain all files within a Figma folder. Figma renamed projects to folders. Parable reads them for each folder it reads. Returns file key, name, thumbnail URL, and last modified timestamp.
> >
> > * **Enables:** catalog design files in each folder with their names, thumbnails, and modification times.
> >
> > * **Scope:** Reads every record from `GET /v2/folders/{id}/files` on each sync. Results are limited to the files the token's user can see.
> >
> > > [accordion] Branches
> > >
> > > Developer identifier: `project_files.branches`
> > >
> > > Branches records list of branches for this file. Only present when `branch_data` query parameter is set to true. It preserves the containing or referenced object needed to reconstruct the provider relationship.
> > >
> > > * **Enables:** expand the nested branches object into its declared child fields for each project file record.
> > > * **Interpretation:** The provider returns `branches` as a list; an absent value does not prove that no related object exists outside the credential's visibility.
> >
> > > [accordion] Key
> > >
> > > Developer identifier: `project_files.branches.key`
> > >
> > > Key is the unique key identifier for the branch file. It is the key of this nested record.
> > >
> > > * **Enables:** identify each branch record.
> > > * **Interpretation:** The provider supplies `key` at one value per branch record, and it is the key of this nested record.
> >
> > > [accordion] Last Modified
> > >
> > > Developer identifier: `project_files.branches.last_modified`
> > >
> > > Last Modified records ISO 8601 timestamp indicating when the branch was last modified. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place project file records on a timeline by last modified and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `last_modified` per branch record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
> >
> > > [accordion] Name
> > >
> > > Developer identifier: `project_files.branches.name`
> > >
> > > Name captures the human-readable name of the branch. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact name returned for each Figma project file record.
> > > * **Interpretation:** The value covers only the project files content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Thumbnail URL
> > >
> > > Developer identifier: `project_files.branches.thumbnail_url`
> > >
> > > Thumbnail URL records URL of the branch's thumbnail image. It retains the exact provider location for the referenced resource.
> > >
> > > * **Enables:** open or trace the exact provider resource referenced by thumbnail URL on a branch record.
> > > * **Interpretation:** The provider supplies `thumbnail_url` as a URL or resource locator on each branch record. Availability still follows the provider's permissions and retention.
> >
> > > [accordion] Key
> > >
> > > Developer identifier: `project_files.key`
> > >
> > > Key is the unique file key identifier used to reference this file across the Figma API. It is the record key, so rows with the same value describe the same record.
> > >
> > > * **Enables:** identify each project file record across syncs.
> > > * **Interpretation:** The provider supplies `key` at one value per project file record, and it is the record key.
> >
> > > [accordion] Last Modified
> > >
> > > Developer identifier: `project_files.last_modified`
> > >
> > > Last Modified records ISO 8601 timestamp indicating when the file was last modified. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place project file records on a timeline by last modified and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `last_modified` per project file record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
> >
> > > [accordion] Name
> > >
> > > Developer identifier: `project_files.name`
> > >
> > > Name captures the human-readable name of the file. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact name returned for each Figma project file record.
> > > * **Interpretation:** The value covers only the project files content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Team ID
> > >
> > > Developer identifier: `project_files.team_id`
> > >
> > > Team ID identifies the id of the parent record in `team_projects`, and Parable copies it from that record. Figma does not return this value with the record. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match project file records to provider records that carry the same team ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `team_id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Thumbnail URL
> > >
> > > Developer identifier: `project_files.thumbnail_url`
> > >
> > > Thumbnail URL records URL of the file's thumbnail image. It retains the exact provider location for the referenced resource.
> > >
> > > * **Enables:** open or trace the exact provider resource referenced by thumbnail URL on a project file record.
> > > * **Interpretation:** The provider supplies `thumbnail_url` as a URL or resource locator on each project file record. Availability still follows the provider's permissions and retention.
>
> > [accordion] Team Component Sets
> >
> > Developer identifier: `team_component_sets`
> >
> > Team Component Sets contain all published component sets for a Figma team. Parable reads them for each team in the Team IDs setting of the connection.
> >
> > * **Enables:** catalog published component families available from each team.
> >
> > * **Scope:** Reads every record from `GET /v1/teams/{team_id}/component_sets` on each sync. Results are limited by the token's granted scopes and team resource allowlist; inaccessible files and teams are absent.
> >
> > > [accordion] Containing Frame
> > >
> > > Developer identifier: `team_component_sets.containing_frame`
> > >
> > > Containing Frame records information about the frame that contains this component set in the file. It preserves the containing or referenced object needed to reconstruct the provider relationship.
> > >
> > > * **Enables:** expand the nested containing frame object into its declared child fields for each team component set record.
> > > * **Interpretation:** The provider returns `containing_frame` as a nested object or reference; an absent value does not prove that no related object exists outside the credential's visibility.
> >
> > > [accordion] Background Color
> > >
> > > Developer identifier: `team_component_sets.containing_frame.backgroundColor`
> > >
> > > Background Color records background color of the containing frame. It preserves the provider's visual treatment for the represented object.
> > >
> > > * **Enables:** reproduce or compare the provider-supplied background color for the represented design or board object.
> > > * **Interpretation:** The provider supplies `backgroundColor` in its own color, opacity, stroke, emoji, or style vocabulary for the represented object.
> >
> > > [accordion] Containing State Group
> > >
> > > Developer identifier: `team_component_sets.containing_frame.containingStateGroup`
> > >
> > > Containing State Group states if the component set is inside a state group, this describes that group. It preserves the provider's current classification of this record.
> > >
> > > * **Enables:** separate team component set records by the exact provider-reported containing state group value when describing their recorded state.
> > > * **Interpretation:** The provider supplies `containingStateGroup` per containing frame record using its own state vocabulary; unknown and missing values must remain distinct.
> >
> > > [accordion] Name
> > >
> > > Developer identifier: `team_component_sets.containing_frame.containingStateGroup.name`
> > >
> > > Name captures the name of the containing state group. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact name returned for each Figma team component set record.
> > > * **Interpretation:** The value covers only the team component sets content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Node ID
> > >
> > > Developer identifier: `team_component_sets.containing_frame.containingStateGroup.nodeId`
> > >
> > > Node ID captures the node ID of the containing state group. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team component set records to provider records that carry the same node ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `nodeId` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Name
> > >
> > > Developer identifier: `team_component_sets.containing_frame.name`
> > >
> > > Name captures the name of the containing frame. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact name returned for each Figma team component set record.
> > > * **Interpretation:** The value covers only the team component sets content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Node ID
> > >
> > > Developer identifier: `team_component_sets.containing_frame.nodeId`
> > >
> > > Node ID captures the node ID of the containing frame. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team component set records to provider records that carry the same node ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `nodeId` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Page ID
> > >
> > > Developer identifier: `team_component_sets.containing_frame.pageId`
> > >
> > > Page ID captures the node ID of the page that contains this frame. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team component set records to provider records that carry the same page ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `pageId` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Page Name
> > >
> > > Developer identifier: `team_component_sets.containing_frame.pageName`
> > >
> > > Page Name captures the name of the page that contains this frame. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact page name returned for each Figma team component set record.
> > > * **Interpretation:** The value covers only the team component sets content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Created At
> > >
> > > Developer identifier: `team_component_sets.created_at`
> > >
> > > Created At records ISO 8601 timestamp indicating when this component set was created. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place team component set records on a timeline by created at and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `created_at` per team component set record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
> >
> > > [accordion] Description
> > >
> > > Developer identifier: `team_component_sets.description`
> > >
> > > Description contains a text description of the component set. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact description returned for each Figma team component set record.
> > > * **Interpretation:** The value covers only the team component sets content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] File Key
> > >
> > > Developer identifier: `team_component_sets.file_key`
> > >
> > > File Key captures the key of the file that contains this component set. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team component set records to provider records that carry the same file key, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `file_key` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Key
> > >
> > > Developer identifier: `team_component_sets.key`
> > >
> > > Key is the unique identifier key for this component set. It is the record key, so rows with the same value describe the same record.
> > >
> > > * **Enables:** identify each team component set record across syncs.
> > > * **Interpretation:** The provider supplies `key` at one value per team component set record, and it is the record key.
> >
> > > [accordion] Name
> > >
> > > Developer identifier: `team_component_sets.name`
> > >
> > > Name captures the name of the component set. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact name returned for each Figma team component set record.
> > > * **Interpretation:** The value covers only the team component sets content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Node ID
> > >
> > > Developer identifier: `team_component_sets.node_id`
> > >
> > > Node ID captures the node ID of this component set within its file. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team component set records to provider records that carry the same node ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `node_id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Team ID
> > >
> > > Developer identifier: `team_component_sets.team_id`
> > >
> > > Team ID identifies the team. Parable adds it from the Team IDs setting of the connection. Figma does not return this value. Parable adds it to each row when it reads the record. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team component set records to provider records that carry the same team ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `team_id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Thumbnail URL
> > >
> > > Developer identifier: `team_component_sets.thumbnail_url`
> > >
> > > Thumbnail URL records URL of the thumbnail image for this component set. It retains the exact provider location for the referenced resource.
> > >
> > > * **Enables:** open or trace the exact provider resource referenced by thumbnail URL on a team component set record.
> > > * **Interpretation:** The provider supplies `thumbnail_url` as a URL or resource locator on each team component set record. Availability still follows the provider's permissions and retention.
> >
> > > [accordion] Updated At
> > >
> > > Developer identifier: `team_component_sets.updated_at`
> > >
> > > Updated At records ISO 8601 timestamp indicating when this component set was last updated. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place team component set records on a timeline by updated at and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `updated_at` per team component set record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
> >
> > > [accordion] User
> > >
> > > Developer identifier: `team_component_sets.user`
> > >
> > > User captures the user who last published this component set. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the team component set record to the provider-reported actor represented by user.
> > > * **Interpretation:** The provider supplies `user` as identity or attribution context on each team component set record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] Handle
> > >
> > > Developer identifier: `team_component_sets.user.handle`
> > >
> > > Handle records display name (handle) of the user. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the figma user record to the provider-reported person or account represented by handle.
> > > * **Interpretation:** The provider supplies `handle` as identity or attribution context on each figma user record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] ID
> > >
> > > Developer identifier: `team_component_sets.user.id`
> > >
> > > ID is the unique identifier of the user. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team component set records to provider records that carry the same ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Img URL
> > >
> > > Developer identifier: `team_component_sets.user.img_url`
> > >
> > > Img URL records URL of the user's profile image. It retains the exact provider location for the referenced resource.
> > >
> > > * **Enables:** open or trace the exact provider resource referenced by img URL on a figma user record.
> > > * **Interpretation:** The provider supplies `img_url` as a URL or resource locator on each figma user record. Availability still follows the provider's permissions and retention.
>
> > [accordion] Team Components
> >
> > Developer identifier: `team_components`
> >
> > Team Components contain all published components for a Figma team. Parable reads them for each team in the Team IDs setting of the connection.
> >
> > * **Enables:** catalog published components available from each team.
> >
> > * **Scope:** Reads every record from `GET /v1/teams/{team_id}/components` on each sync. Results are limited by the token's granted scopes and team resource allowlist; inaccessible files and teams are absent.
> >
> > > [accordion] Component Set ID
> > >
> > > Developer identifier: `team_components.component_set_id`
> > >
> > > Component Set ID identifies if this component is part of a component set (variants), the ID of the parent component set. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team component records to provider records that carry the same component set ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `component_set_id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Component Set Name
> > >
> > > Developer identifier: `team_components.component_set_name`
> > >
> > > Component Set Name records if this component is part of a component set, the name of the parent component set. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact component set name returned for each Figma team component record.
> > > * **Interpretation:** The value covers only the team components content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Containing Frame
> > >
> > > Developer identifier: `team_components.containing_frame`
> > >
> > > Containing Frame records information about the frame that contains this component in the file. It preserves the containing or referenced object needed to reconstruct the provider relationship.
> > >
> > > * **Enables:** expand the nested containing frame object into its declared child fields for each team component record.
> > > * **Interpretation:** The provider returns `containing_frame` as a nested object or reference; an absent value does not prove that no related object exists outside the credential's visibility.
> >
> > > [accordion] Background Color
> > >
> > > Developer identifier: `team_components.containing_frame.backgroundColor`
> > >
> > > Background Color captures the background color of the containing frame. It preserves the provider's visual treatment for the represented object.
> > >
> > > * **Enables:** reproduce or compare the provider-supplied background color for the represented design or board object.
> > > * **Interpretation:** The provider supplies `backgroundColor` in its own color, opacity, stroke, emoji, or style vocabulary for the represented object.
> >
> > > [accordion] Containing State Group
> > >
> > > Developer identifier: `team_components.containing_frame.containingStateGroup`
> > >
> > > Containing State Group states if the component is inside a state group, information about that group. It preserves the provider's current classification of this record.
> > >
> > > * **Enables:** separate team component records by the exact provider-reported containing state group value when describing their recorded state.
> > > * **Interpretation:** The provider supplies `containingStateGroup` per containing frame record using its own state vocabulary; unknown and missing values must remain distinct.
> >
> > > [accordion] Name
> > >
> > > Developer identifier: `team_components.containing_frame.containingStateGroup.name`
> > >
> > > Name captures the name of the state group. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact name returned for each Figma team component record.
> > > * **Interpretation:** The value covers only the team components content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Node ID
> > >
> > > Developer identifier: `team_components.containing_frame.containingStateGroup.nodeId`
> > >
> > > Node ID captures the node ID of the state group. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team component records to provider records that carry the same node ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `nodeId` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Name
> > >
> > > Developer identifier: `team_components.containing_frame.name`
> > >
> > > Name captures the name of the containing frame. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact name returned for each Figma team component record.
> > > * **Interpretation:** The value covers only the team components content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Node ID
> > >
> > > Developer identifier: `team_components.containing_frame.nodeId`
> > >
> > > Node ID captures the node ID of the containing frame. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team component records to provider records that carry the same node ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `nodeId` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Page ID
> > >
> > > Developer identifier: `team_components.containing_frame.pageId`
> > >
> > > Page ID captures the node ID of the page that contains this frame. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team component records to provider records that carry the same page ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `pageId` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Page Name
> > >
> > > Developer identifier: `team_components.containing_frame.pageName`
> > >
> > > Page Name captures the name of the page that contains this frame. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact page name returned for each Figma team component record.
> > > * **Interpretation:** The value covers only the team components content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Created At
> > >
> > > Developer identifier: `team_components.created_at`
> > >
> > > Created At records ISO 8601 timestamp indicating when the component was first created/published. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place team component records on a timeline by created at and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `created_at` per team component record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
> >
> > > [accordion] Description
> > >
> > > Developer identifier: `team_components.description`
> > >
> > > Description contains a text description of the component, typically set by the designer. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact description returned for each Figma team component record.
> > > * **Interpretation:** The value covers only the team components content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] File Key
> > >
> > > Developer identifier: `team_components.file_key`
> > >
> > > File Key captures the key of the Figma file that contains this component. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team component records to provider records that carry the same file key, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `file_key` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Key
> > >
> > > Developer identifier: `team_components.key`
> > >
> > > Key is the unique identifier key for the component. It is the record key, so rows with the same value describe the same record.
> > >
> > > * **Enables:** identify each team component record across syncs.
> > > * **Interpretation:** The provider supplies `key` at one value per team component record, and it is the record key.
> >
> > > [accordion] Name
> > >
> > > Developer identifier: `team_components.name`
> > >
> > > Name captures the display name of the component. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact name returned for each Figma team component record.
> > > * **Interpretation:** The value covers only the team components content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Node ID
> > >
> > > Developer identifier: `team_components.node_id`
> > >
> > > Node ID captures the node ID of this component within its containing file. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team component records to provider records that carry the same node ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `node_id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Team ID
> > >
> > > Developer identifier: `team_components.team_id`
> > >
> > > Team ID identifies the team. Parable adds it from the Team IDs setting of the connection. Figma does not return this value. Parable adds it to each row when it reads the record. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team component records to provider records that carry the same team ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `team_id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Thumbnail URL
> > >
> > > Developer identifier: `team_components.thumbnail_url`
> > >
> > > Thumbnail URL records URL of the component's thumbnail image. It retains the exact provider location for the referenced resource.
> > >
> > > * **Enables:** open or trace the exact provider resource referenced by thumbnail URL on a team component record.
> > > * **Interpretation:** The provider supplies `thumbnail_url` as a URL or resource locator on each team component record. Availability still follows the provider's permissions and retention.
> >
> > > [accordion] Updated At
> > >
> > > Developer identifier: `team_components.updated_at`
> > >
> > > Updated At records ISO 8601 timestamp indicating when the component was last updated. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place team component records on a timeline by updated at and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `updated_at` per team component record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
> >
> > > [accordion] User
> > >
> > > Developer identifier: `team_components.user`
> > >
> > > User captures the user who last published or updated the component. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the team component record to the provider-reported actor represented by user.
> > > * **Interpretation:** The provider supplies `user` as identity or attribution context on each team component record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] Handle
> > >
> > > Developer identifier: `team_components.user.handle`
> > >
> > > Handle captures the user's display name / handle. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the figma user record to the provider-reported person or account represented by handle.
> > > * **Interpretation:** The provider supplies `handle` as identity or attribution context on each figma user record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] ID
> > >
> > > Developer identifier: `team_components.user.id`
> > >
> > > ID is the unique numeric identifier for the user, represented as a string. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team component records to provider records that carry the same ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Img URL
> > >
> > > Developer identifier: `team_components.user.img_url`
> > >
> > > Img URL records URL of the user's profile image / avatar. It retains the exact provider location for the referenced resource.
> > >
> > > * **Enables:** open or trace the exact provider resource referenced by img URL on a figma user record.
> > > * **Interpretation:** The provider supplies `img_url` as a URL or resource locator on each figma user record. Availability still follows the provider's permissions and retention.
>
> > [accordion] Team Projects
> >
> > Developer identifier: `team_projects`
> >
> > Team Projects contain every folder of a Figma team, with its subfolders at every depth. Figma renamed projects to folders. Parable reads them for each team in the Team IDs setting of the connection.
> >
> > * **Enables:** enumerate the folders inside each configured Figma team, and place each one in the team's folder tree.
> >
> > * **Scope:** Reads every record from `GET /v2/teams/{team_id}/folders` on each sync, then the subfolders of each folder from `GET /v2/folders/{id}/folders`, up to 16 levels down. A sync that cannot read a folder's subfolders fails and keeps the previous folders. Results are limited to the folders the token's user can see.
> >
> > > [accordion] Created At
> > >
> > > Developer identifier: `team_projects.created_at`
> > >
> > > Created At records when the folder was created. It anchors the folder on the team's timeline.
> > >
> > > * **Enables:** place folders on a timeline by creation time.
> > > * **Interpretation:** The provider supplies `created_at` as a UTC ISO 8601 timestamp; a missing value means Figma did not report it.
> >
> > > [accordion] ID
> > >
> > > Developer identifier: `team_projects.id`
> > >
> > > ID is the unique identifier for the folder within Figma. It is the record key, so rows with the same value describe the same record.
> > >
> > > * **Enables:** identify each team project record across syncs.
> > > * **Interpretation:** The provider supplies `id` at one value per team project record, and it is the record key.
> >
> > > [accordion] Name
> > >
> > > Developer identifier: `team_projects.name`
> > >
> > > Name records human-readable name of the folder. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact name returned for each Figma team project record.
> > > * **Interpretation:** The value covers only the team projects content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Parent Folder ID
> > >
> > > Developer identifier: `team_projects.parent_folder_id`
> > >
> > > Parent Folder ID identifies the folder that contains this folder. It is null for a top-level folder in the team.
> > >
> > > * **Enables:** place each folder in its team's folder tree.
> > > * **Interpretation:** The provider supplies `parent_folder_id` per folder record; a null value means the folder sits at the top level of the team.
> >
> > > [accordion] Sharing Audience Control
> > >
> > > Developer identifier: `team_projects.sharing_audience_control`
> > >
> > > Sharing Audience Control records who can view or edit the folder by default in Figma.
> > >
> > > * **Enables:** tell open folders from invite-only folders.
> > > * **Interpretation:** Figma reports one of `plan_view`, `plan_edit`, `invite_only`, `workspace_view` or `workspace_edit`; unknown labels are kept as returned.
> >
> > > [accordion] Team ID
> > >
> > > Developer identifier: `team_projects.team_id`
> > >
> > > Team ID identifies the team. Parable adds it from the Team IDs setting of the connection. Figma does not return this value. Parable adds it to each row when it reads the record. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team project records to provider records that carry the same team ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `team_id` as a record-level identifier. Its values are not guaranteed to be unique.
>
> > [accordion] Team Styles
> >
> > Developer identifier: `team_styles`
> >
> > Team Styles contain all published styles for a Figma team. Parable reads them for each team in the Team IDs setting of the connection.
> >
> > * **Enables:** catalog published styles available from each team.
> >
> > * **Scope:** Reads every record from `GET /v1/teams/{team_id}/styles` on each sync. Results are limited by the token's granted scopes and team resource allowlist; inaccessible files and teams are absent.
> >
> > > [accordion] Created At
> > >
> > > Developer identifier: `team_styles.created_at`
> > >
> > > Created At records ISO 8601 timestamp indicating when the style was created. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place team style records on a timeline by created at and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `created_at` per team style record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
> >
> > > [accordion] Description
> > >
> > > Developer identifier: `team_styles.description`
> > >
> > > Description records description of the style provided by the creator. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact description returned for each Figma team style record.
> > > * **Interpretation:** The value covers only the team styles content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] File Key
> > >
> > > Developer identifier: `team_styles.file_key`
> > >
> > > File Key captures the key of the file that contains this style. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team style records to provider records that carry the same file key, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `file_key` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Key
> > >
> > > Developer identifier: `team_styles.key`
> > >
> > > Key is the unique style key that identifies this style across Figma. It is the record key, so rows with the same value describe the same record.
> > >
> > > * **Enables:** identify each team style record across syncs.
> > > * **Interpretation:** The provider supplies `key` at one value per team style record, and it is the record key.
> >
> > > [accordion] Name
> > >
> > > Developer identifier: `team_styles.name`
> > >
> > > Name records human-readable name of the style. It keeps the exact text, label, or authored value needed to interpret the record.
> > >
> > > * **Enables:** inspect the exact name returned for each Figma team style record.
> > > * **Interpretation:** The value covers only the team styles content returned by this Figma operation; unrequested canvas content is not inferred.
> >
> > > [accordion] Node ID
> > >
> > > Developer identifier: `team_styles.node_id`
> > >
> > > Node ID captures the node ID within the file where this style is defined. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team style records to provider records that carry the same node ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `node_id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Sort Position
> > >
> > > Developer identifier: `team_styles.sort_position`
> > >
> > > Sort Position reports sort position of the style. It preserves the stated measure at this record's granularity.
> > >
> > > * **Enables:** order or classify team style records using the provider-defined sort position value.
> > > * **Interpretation:** The provider supplies `sort_position` at team style granularity as a provider-defined ordinal or planning value rather than elapsed time or money; zero and missing are not interchangeable.
> >
> > > [accordion] Style Type
> > >
> > > Developer identifier: `team_styles.style_type`
> > >
> > > Style Type captures the type of the style (e.g., FILL, TEXT, EFFECT, GRID). It preserves the provider's current classification of this record.
> > >
> > > * **Enables:** separate team style records by the exact provider-reported style type value when describing their recorded state.
> > > * **Interpretation:** The provider supplies `style_type` per team style record using its own state vocabulary; unknown and missing values must remain distinct.
> >
> > > [accordion] Team ID
> > >
> > > Developer identifier: `team_styles.team_id`
> > >
> > > Team ID identifies the team. Parable adds it from the Team IDs setting of the connection. Figma does not return this value. Parable adds it to each row when it reads the record. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team style records to provider records that carry the same team ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `team_id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Thumbnail URL
> > >
> > > Developer identifier: `team_styles.thumbnail_url`
> > >
> > > Thumbnail URL records URL to a thumbnail image representing this style. It retains the exact provider location for the referenced resource.
> > >
> > > * **Enables:** open or trace the exact provider resource referenced by thumbnail URL on a team style record.
> > > * **Interpretation:** The provider supplies `thumbnail_url` as a URL or resource locator on each team style record. Availability still follows the provider's permissions and retention.
> >
> > > [accordion] Updated At
> > >
> > > Developer identifier: `team_styles.updated_at`
> > >
> > > Updated At records ISO 8601 timestamp indicating when the style was last updated. It anchors the named event or boundary on the record's timeline.
> > >
> > > * **Enables:** place team style records on a timeline by updated at and select the records within an explicit reporting window.
> > > * **Interpretation:** The provider supplies `updated_at` per team style record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
> >
> > > [accordion] User
> > >
> > > Developer identifier: `team_styles.user`
> > >
> > > User captures the user who published or last updated this style. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the team style record to the provider-reported actor represented by user.
> > > * **Interpretation:** The provider supplies `user` as identity or attribution context on each team style record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] Handle
> > >
> > > Developer identifier: `team_styles.user.handle`
> > >
> > > Handle records display name (handle) of the user. It keeps the provider-reported person or account context attached to the record.
> > >
> > > * **Enables:** attribute the style user record to the provider-reported person or account represented by handle.
> > > * **Interpretation:** The provider supplies `handle` as identity or attribution context on each style user record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
> >
> > > [accordion] ID
> > >
> > > Developer identifier: `team_styles.user.id`
> > >
> > > ID is the unique identifier of the user. It is needed to resolve references that repeat the same provider identifier.
> > >
> > > * **Enables:** match team style records to provider records that carry the same ID, without assuming that this field alone makes every row unique.
> > > * **Interpretation:** The provider supplies `id` as a record-level identifier. Its values are not guaranteed to be unique.
> >
> > > [accordion] Img URL
> > >
> > > Developer identifier: `team_styles.user.img_url`
> > >
> > > Img URL records URL to the user's avatar image. It retains the exact provider location for the referenced resource.
> > >
> > > * **Enables:** open or trace the exact provider resource referenced by img URL on a style user record.
> > > * **Interpretation:** The provider supplies `img_url` as a URL or resource locator on each style user record. Availability still follows the provider's permissions and retention.

> [tab] Troubleshooting
>
> | Error | Meaning | Solution |
> | - | - | - |
> | `403 Invalid token` | Bad PAT, or PAT was revoked | Re-mint from Figma Settings → Security; confirm minting user is still active |
> | `403 Invalid scope` | PAT missing a required scope | Re-mint with the full scope list above, including `folders:read`. Figma no longer offers `projects:read` for new tokens. |
> | `403 You don't seem to have permission to do that` on `GET /v2/teams/{team_id}/folders` | The token is valid, but its user cannot see that team | Use a token from a member of the team, or remove the team ID from the connection. For a Plan Access Token, see the allowlist row below. |
> | `404 Not found` on a file or team | Minting user lacks access | Add service-account user to the team, or remove the missing resource |
> | `403` on a Plan Access Token | Team is outside the token's resource allowlist | Edit the token at figma.com/developers/tokens and add the team, or allow all resources |
> | `429 Too many requests` | Rate limit exceeded | Parable respects `Retry-After` and backs off automatically |
> | `Activity logs return empty` | The data stream is disabled by default | Enable the `activity_logs` data stream in Provider settings. It requires an Enterprise plan and org admin access. |
>
> #### Common Issues
>
> #### The connection reports an invalid token
>
> Confirm you copied the full token string -- Figma PATs are 40+ characters and may contain hyphens. Trailing whitespace from a paste also fails; re-paste into the Provider form.
>
> #### `activity_logs` returns 402 / `payment_required`
>
> Activity logs are an Enterprise-only feature and are disabled by default. Enable the `activity_logs` data stream only on Enterprise plans with org admin access.
>
> **[Figma REST API](https://www.figma.com/developers/api)** — Full endpoint reference
>
> **[Personal access tokens](https://www.figma.com/developers/api#access-tokens)** — Official PAT setup guide including scope semantics


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.