Get File Metadata

figma.get_file_meta

ActionBusiness appsconnection required

Calls the Figma API with the connection's credentials.

Fetch a file's metadata — name, containing folder, creator, last editor and link access — without downloading the document.

Connection

Required: Yes — the node will not save without one
Auth type: OAuth 2.0
Providers: Figma
Secret shape: {"client_id": "…", "client_secret": "…", "refresh_token": "…"}, or {"personal_access_token": "figd_…"}
Config it needs: base_url, plan_api_id
Resolved by: config.connection_id, else node.connection_id

1 field, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

Field	Type	Required	Default	Constraints	Example
file_key The Figma file key — the segment after /design/ or /file/ in the file URL.	string	Yes	—	—	—

One shape.

Field	Type	Example
file.name The name of the file.	string	—
file.folder_name The project or folder containing the file.	string	—
file.last_touched_at UTC ISO 8601 time the file content was last modified.	string	—
file.editorType Which editor the file belongs to.	string	—
file.url The URL of the file.	string	—
file.version The file's version number.	string	—

{
  "file": {
    "editorType": "",
    "folder_name": "",
    "last_touched_at": "",
    "name": "",
    "url": "",
    "version": ""
  }
}

In a technical demo we add the Figma connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.