Projects ListTeamProjects
CertifiedList the projects of a Figma team
Projects ListTeamProjects
List the projects of a Figma team
Calls the Figma GET /v1/teams/: team_id/projects endpoint.
type: io.kestra.plugin.figma.projects.ListTeamProjectsExamples
List all projects of a Figma team
id: figma_list_team_projects
namespace: company.team
tasks:
- id: list_team_projects
type: io.kestra.plugin.figma.projects.ListTeamProjects
accessToken: "{{ secret('FIGMA_ACCESS_TOKEN') }}"
teamId: "123456789"
Installation
Our standard Docker images already include this plugin. If you use a -slim image or another setup, install it with the following command:
kestractl plugins get io.kestra.plugin:plugin-figma --compatible-for $KESTRA_VERSION For kestractl, use your Kestra version with --compatible-for, or specify an exact plugin version.
For Kestra CLI, replace LATEST with a specific version or version range to pin the plugin version.
Properties
accessToken *string
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.
teamId *string
The Figma team ID
assets
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.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset 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.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150baseUrl string
https://api.figma.com/v1Figma API base URL
Defaults to the public Figma REST API. Override only to point at a self-hosted proxy or a test server.
fetchType string
FETCHSTOREFETCHFETCH_ONENONEHow to handle the fetched projects
Outputs
row object
The single fetched item
Populated when fetchType is FETCH_ONE.
rows array
The list of fetched items
Populated when fetchType is FETCH.
size integer
The number of items stored or fetched
total integer
The total number of items returned by the Figma API for this request
Only populated for list-shaped responses (e.g. comments, projects, files).
uri string
uriThe internal storage URI of the stored payload
Populated when fetchType is STORE.
