PERS icon

PERS

Interact with the PERS Loyalty API

Actions14

Files → Generate Signed URL

AI-generated

Summary

Requests an S3 signed URL from the PERS API for uploading (PUT) or downloading (GET) a file tied to a PERS entity such as a business, campaign, redemption, tenant, token or user.

Inputs

  • Entity Type (required) — Entity the file belongs to: business, campaign, redemption, tenant, token (default) or user.
  • Entity ID (required) — Unique identifier of the entity.
  • Signed URL Type (required) — GET (Download, default) or PUT (Upload).
  • File Extension (required) — File extension such as png, jpg or pdf.
  • File Name — Optional file name. It is omitted from the request when empty.

Output shape

One item per input item, containing the JSON response from the PERS API for POST /files/entity-storage-url. The signed URL is expected in it.

The source doesn't show the response schema. The Upload File operation reads signedUrl or url from this same endpoint, so those fields are likely. This operation does not upload or download any file itself. You must use the returned URL in a later step, for example an HTTP Request node. With Continue On Fail enabled, errors come back as { error: message } for the affected item. Requests use the persApi credentials.

Examples

Example 1: Get a download link for a token's image

Entity Type=Token, Entity ID=, Signed URL Type=GET (Download), File Extension=png

Example 2: Get an upload URL for a business logo, then PUT the file with an HTTP Request node

Entity Type=Business, Entity ID=, Signed URL Type=PUT (Upload), File Extension=jpg, File Name=logo

Links

Discussion