Figma ExportImage

Figma ExportImage

Certified

Export Figma nodes as images

Calls the Figma GET /v1/images/: key endpoint and downloads every returned image in the same run, storing them in Kestra's internal storage rather than exposing Figma's raw (and short-lived) URLs as output.

yaml
type: io.kestra.plugin.figma.files.ExportImage

Export two nodes of a Figma file as PNG images

yaml
id: figma_export_image
namespace: company.team

tasks:
  - id: export_image
    type: io.kestra.plugin.figma.files.ExportImage
    accessToken: "{{ secret('FIGMA_ACCESS_TOKEN') }}"
    fileKey: "abc123XYZ"
    nodeIds:
      - "1:2"
      - "1:3"
    format: PNG
Properties

Figma access token

A personal access token generated from your Figma account settings (Account Settings > Personal access tokens), scoped to what the task needs to do. A valid OAuth 2.0 access token obtained through your own authorization flow also works — this plugin does not implement the OAuth flow itself, only PAT-style bearer tokens passed as-is.

The Figma file key

Found in the file's URL: https://www.figma.com/file/: fileKey/....

SubTypestring

The node IDs to export

Must contain at least one ID — the Figma API returns a 400 error otherwise.

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
Defaulthttps://api.figma.com/v1

Figma API base URL

Defaults to the public Figma REST API. Override only to point at a self-hosted proxy or a test server.

DefaultPNG
Possible Values
PNGJPGSVGPDF

The output image format

A scaling factor to apply to the exported image

Must be between 0.01 and 4. Ignored for SVG and PDF.

Whether to include the node ID as an attribute on exported SVG elements

Whether to use the full node bounding box, ignoring any clipping

SubTypestring

Map of node ID to the internal storage URI of the exported image