ÃÛ¶¹ÊÓƵ

ÃÛ¶¹ÊÓƵ Workfront plan*

Pro or higher

ÃÛ¶¹ÊÓƵ Workfront license*

Plan, Work

ÃÛ¶¹ÊÓƵ Workfront Fusion license**

Current license requirement: No Workfront Fusion license requirement.

Or

Legacy license requirement: Workfront Fusion for Work Automation and Integration

Product

Current product requirement: If you have the Select or Prime ÃÛ¶¹ÊÓƵ Workfront plan, your organization must purchase ÃÛ¶¹ÊÓƵ Workfront Fusion as well as ÃÛ¶¹ÊÓƵ Workfront to use functionality described in this article. Workfront Fusion is included in the Ultimate Workfront plan.

Or

Legacy product requirement: Your organization must purchase ÃÛ¶¹ÊÓƵ Workfront Fusion as well as ÃÛ¶¹ÊÓƵ Workfront to use functionality described in this article.

Base URL

https://api.figma.com/v1

API version

v1

API tag

v1.8.25

Connection

For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.

File ID

Enter or map the File ID of the file that you want to add a delete a comment from.

Comment

Enter the text of the comment you want to delete.

Connection

For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.

File ID

Enter or map the File ID of the file that you want to retrieve comments for.

• If you do not know the ID, click Find Files and enter or map the ID of the project that the file is associated with, then select the file.

• If you do not know the project's ID, click Find Projects and enter or map the ID of the team that owns the project the file is associated with, then select the project, then select the file.

Limit

Enter or map the maximum number of comments you want the module to return during each scenario execution cycle.

Connection

For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.

File ID

Enter or map the File ID of the file that you want to post a comment to.

• If you do not know the file's ID, click Find Files and enter or map the ID of the project that the file is associated with, then select the file.

• If you are attempting to find the file's ID and do not know the project's ID, click Find Projects and enter or map the ID of the team that owns the project the file is associated with. Select the project, then select the file.

Comment

Enter the text of the comment.

Connection

For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.

Object type

Select the type of object you want to retrieve.

• File

  The module returns the document referred to by Key as a JSON object. The file key can be parsed from any Figma file URL.

  For fields, see Get a file or image: File.

• File nodes

  Returns the nodes referenced to by IDs as a JSON object. The nodes are retrieved from the Figma file referenced to by Key.

  For fields, see Get a file or image: File nodes.

• Image

  The module renders images from a file.

  For fields, see Get a file or image: Image.

• Image fills

  The module returns download links for all images present in image fills in a document. Image fills are how Figma represents any user-supplied images. When you drag an image into Figma, Figma creates a rectangle with a single fill that represents the image, and the user is able to transform the rectangle (and properties on the fill).

  For fields, see Get a file or image: Image fills.

File key

Select the file that you want to return JSON from.

Version ID

Enter or map the version of the file you want the module to return. For the current module, leave this field blank.

Node IDs

To return only a subset of the document, enter the nodes that you want the module to return. The module returns the listed nodes, their children, and anything between the root node and the listed nodes.

For each node that you want to return, click Add and enter the text of the node.

Depth

Enter or map an integer that represents how deep into the document tree you want to return results for.

Example:

• To return pages only, enter 1.

• To return pages and top level objects, enter 2.

To return all nodes, leave this field blank.

Geometry

To return vector data, enter paths.

Plugin data

A comma separated list of plugin IDs and/or the string "shared". Any data present in the document written by those plugins will be included in the result in the pluginData and sharedPluginData properties.

Branch data

Enable this option to return branch metadata for the requested file. If the file is a branch, the main file's key is included in the returned response. If the file has branches, their metadata is included in the returned response. Default: false.

File key

Select the file that you want to return JSON from.

Node IDs

Enter the nodes that you want the module to return and convert

For each node that you want to return, click Add and enter the text of the node.

Version ID

Enter or map the version of the file you want the module to return. For the current module, leave this field blank.

Depth

Enter or map an integer that represents how deep into the document tree you want to return results for.

Example:

• To return pages only, enter 1.

• To return pages and top level objects, enter 2.

To return all nodes, leave this field blank.

Geometry

To return vector data, enter paths.

Plugin data

A comma separated list of plugin IDs and/or the string "shared". Any data present in the document written by those plugins will be included in the result in the pluginData and sharedPluginData properties.

File key

Select the file that you want to return JSON from.

Node IDs

Enter the nodes that you want the module to render.

For each node that you want to render, click Add and enter the text of the node.

Scale

To scale the image, enter or map the scaling factor. This number must be between 0.01 and 4.

Format

Select the format for the image output.

• JPG

• PNG

• SVG

• PDF

SVG - Include ID

Enable this option to include ID attributes for all SVG elements. Default: false.

SVG - Simplify Stroke

Enable this option to simplify inside/outside strokes and use stroke attribute if possible instead of <mask>. Default: true.

Use absolute bounds

Enable this option to use the full dimensions of the node regardless of whether or not it is cropped or the space around it is empty. Use this to export text nodes without cropping. Default: false.

Version ID

Enter or map the version of the file you want the module to return. For the current module, leave this field blank.

File key

Select the file that you want to return JSON from.

Connection

For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.

File ID

Enter or map the File ID of the file that you want retrieve version history for.

• If you do not know the file's ID, click Find Files and enter or map the ID of the project that the file is associated with, then select the file.

• If you are attempting to find the file's ID and do not know the project's ID, click Find Projects and enter or map the ID of the team that owns the project the file is associated with. Select the project, then select the file.

Limit

Enter or map the maximum number of records you want the module to return during each scenario execution cycle.

Connection

For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.

File ID

Enter or map the Project ID the project that you want retrieve files for.

• If you do not know the projects's ID, click Find Projects and enter or map the ID of the team that the project is are associated with, then select the project.

Limit

Enter or map the maximum number of records you want the module to return during each scenario execution cycle.

Connection

For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.

Team ID

Enter or map the Project ID of the project that you want to retrieve files for. The team ID can be found in the URL of the team's page in Figma

Limit

Enter or map the maximum number of records you want the module to return during each scenario execution cycle.

Connection

For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.

<Object> key

Enter the key (unique identifier) of the object you want to retrieve.

Team ID

Enter or map the ID of the team that the record or records are associated with.

Page Size

Enter or map the number or results to return per page. Default: 30.

After

Enter or map the number of the result after which to start retrieving results. This can be combined with the Page Size field to paginate results.

This value does not correspond to object IDs.

This field cannot be used in combination with the Before field.

Before

Enter or map the number of the result before which to start retrieving results. This can be combined with the Page Size field to paginate results.

This value does not correspond to object IDs.

This field cannot be used in combination with the After field.

Connection

For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.

URL

Enter a path relative to https://api.figma.com/v1/.

For example: files/7179110/comments

Method

Select the HTTP request method you need to configure the API call. For more information, see HTTP request methods in ÃÛ¶¹ÊÓƵ Workfront Fusion.

Headers

Add the headers of the request in the form of a standard JSON object.

For example, {"Content-type":"application/json"}

Workfront Fusion adds the authorization headers for you.

Query String

Add the query for the API call in the form of a standard JSON object.

For example: {"name":"something-urgent"}

Body

Add the body content for the API call in the form of a standard JSON object.

Note:

When using conditional statements such as if in your JSON, put the quotation marks outside of the conditional statement.

Webhook

Select the webhook that the module watches.

To add a new webhook:

1. Click Add next to the Webhook field.

2. Select the connection you want to use for this webhook. For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.

3. Select the event type that you want the module to watch.

4. Enter the ID of the team whose events you want the webhook to watch.

5. Enter the Status or Description of events that you want the webhook to watch.

6. Click Save to save the webhook and return to the module.