Frontify icon

Frontify

Interact with Frontify

Overview

This node integrates with the Frontify platform, enabling users to interact programmatically with various Frontify resources such as assets, projects, folders, brands, creatives, and accounts. Specifically, for the Asset - Get operation, it retrieves detailed information about a single asset by its unique identifier.

Common scenarios where this node is beneficial include:

  • Fetching metadata and details of a specific digital asset stored in Frontify.
  • Retrieving asset preview URLs, tags, licenses, and permissions for use in automated workflows.
  • Integrating asset data into other systems or processes without manual lookup.

Practical example:

  • Automatically retrieve an image asset's preview URL and metadata after it has been uploaded, to display it in a custom dashboard or send it via email.

Properties

Name Meaning
Authentication Means of authenticating with Frontify; currently supports "Access Token" authentication.
Asset ID The unique identifier of the asset to retrieve; required for the Get operation.
Additional Options Optional parameters including:
• Token (an additional token string, password type)
• Domain (the Frontify domain URL, default: https://example.frontify.com)

Output

The output JSON object contains detailed information about the requested asset, including but not limited to:

  • id: The asset's unique identifier.
  • previewUrl: For image assets, a URL to a preview image.
  • creator: Object containing creator's id and name.
  • createdAt: Timestamp when the asset was created.
  • modifier: Object containing last modifier's id and name.
  • modifiedAt: Timestamp of last modification.
  • title: Asset title.
  • description: Asset description.
  • attachments: Array of attachments with their id and name.
  • externalId: External identifier if set.
  • tags: Array of tags with value and source.
  • copyright: Object with copyright status and notice.
  • expiresAt: Expiration date/time if applicable.
  • licenses: Array of licenses with id and title.
  • metadataValues: Array of metadata entries, each with id, metadataField label, and value.
  • status: Current status of the asset.
  • relatedAssets: Object with total count of related assets.
  • comments: Object with total count of comments.
  • currentUserPermissions: Permissions object indicating whether the current user can edit, delete, download, or comment on the asset.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the Frontify API.
  • The node uses GraphQL queries and mutations to communicate with Frontify.
  • Optionally, the user can specify a custom Frontify domain URL.
  • No additional external services are required beyond access to the Frontify platform.

Troubleshooting

  • Missing or invalid Asset ID: The operation requires a valid asset ID. Ensure the ID is correctly provided and corresponds to an existing asset.
  • Authentication errors: If the API key or token is missing, expired, or incorrect, the node will fail to authenticate. Verify that the correct access token is configured.
  • Network or domain issues: If using a custom domain, ensure the domain URL is correct and accessible.
  • Permission errors: The current user’s API token must have sufficient permissions to view the asset; otherwise, permission-related errors may occur.
  • GraphQL errors: Any malformed queries or unexpected API changes could cause errors. Review error messages for details and update the node or credentials accordingly.

Links and References

Discussion