For the complete documentation index, see llms.txt. You can also append .md to any page URL to get its markdown version.
Skip to main content
For the complete documentation index, see llms.txt.

For the complete documentation index, see llms.txt

Control URL lifetime

When you publish a workflow, Signicat Mint generates a public workflow URL where you can direct your end-users to start a new journey.

You can control the availability and lifetime of this URL, for example when you want to restrict access to a user journey, by configuring temporary URLs.

There are two types of temporary URLs in Mint:

  • Time-limited journey URLs
  • Return URLs
Default lifetime

By default, every temporary URL has a lifetime of 60 seconds. After this time expires, the URL can no longer be used to open or resume the user journey.

Manage URL lifetime in Mint​

You can control the lifetime of generated URLs in the following ways:

Prerequisites​

Before you begin, make sure you have configured access to Signicat Mint, as explained below:

Mint prerequisites

For the complete documentation index, see llms.txt

To proceed with the tutorial, you must have completed the following initial preparations:

  1. Sign up to the Signicat Dashboard and register your profile. For more details, see the Get started with Signicat guide.
  2. In the Dashboard, make sure you have set up an organisation, an account and a domain.
    Sandbox and production accounts

    We recommend you create a sandbox account to test our services before going live. Sandbox and production accounts must be set up separately.

If you require assistance, you can contact us by creating a support ticket in the Dashboard.

For the complete documentation index, see llms.txt

Mint permissions

To create and edit Mint workflows, your user in the Signicat Dashboard needs the Account Viewer role and at least one of the following roles:

  • Mint Administrator
  • Mint Editor
  • Mint Workflow Builder Editor

For more information, see Mint roles and permissions.

Time-limited journey URLs​

Time-limited journey URLs are unique, temporary URLs for each specific journey instance that you can create in the Mint Builder or through the Mint API.

Understanding URLs in the Mint Builder​

Mint supports two types of URLs that you can create to start user journeys:

  • General workflow URLs
  • Time-limited journey URLs

General workflow URLs

  • Public workflow URLs that have no time-to-live (TTL) and never expire.
  • Mint creates the URL and copies it to your clipboard when you publish a flow.
  • Anyone with the link can start a user journey.
Example of a general workflow URL
https://<YOUR_SIGNICAT_DOMAIN>/mint/b182fbe62cfe4ff1b4725aeb8e5b98ad

Time-limited journey URLs

  • Time-limited journey URLs are unique and valid only for a single journey instance.
  • You generate them manually in the Mint Builder or through the Mint API.
  • Each URL contains a token parameter and expires after a set time.
  • Anyone with the link can start a user journey before it expires.
Example of a time-limited journey URL
https://<YOUR_SIGNICAT_DOMAIN>/mint/i/2105bea498c7499fa1ffc79e176204c8?
token=eyJhbGciOiJIUzI1NiIsImtpZCI6IjEiLCJ0eXAiOiJKV1QifQ...
Default lifetime

By default, every time-limited URL has a lifetime (time to live) of 60 seconds. After this time expires, the URL can no longer be used to open or resume the user journey.

URL security

Time-limited journey URLs do not verify the identity of the person opening them. Anyone with the link can access the journey until the link expires. Treat these URLs as confidential and share them only through trusted channels.

Enable time-limited journey URLs​

To enable time-limited URLs for your journeys in the Mint Builder, do the following:

  1. Go to Signicat Mint and open your workflow.
  2. Click the gear icon (settings) in the top-right corner to open the settings menu.
  3. In the Flow settings menu, go to the Advanced tab.
  4. In the Time-limited journey URLs section, enable Trigger time-limited journey URLs.
  5. Optional. Edit the URL lifetime in Default journey URL lifetime (in seconds). By default, this is set to 60 seconds.
  6. Close Flow settings and select Save at the top right.
Note

When your enable time-limited URLs, you can only trigger journeys manually from the Mint Dashboard or through the Mint API. Publishing through the general public URLs will no longer be available.

Trigger time-limited journeys in the Mint Builder​

To start a journey with a time-limited URL from the Mint Builder, do the following:

  1. Open your flow in the Mint Builder.
  2. Click the kebab menu (three vertical dots) at the top right and select Start journey and copy URL.
  3. Optional. In the confirmation window, edit the default value in the Journey URL lifetime field.
  4. To start a new journey, click Start journey. This will start your journey and copy its temporary URL to your clipboard.
Journey URL lifetime

Remember that your journey URL will expire after your set time. Once this time expires, the URL can no longer be used to open or resume the user journey.

Trigger time-limited journeys in the Mint API​

When you start a user journey programmatically with the Start journey (POST /workflows/{workflowId}/start) endpoint in the Signicat Mint API, the response returns a journeyId and a time-limited journeyUrl.

To trigger a journey with a time-limited URL, you need to use the journeyUrl you receive in the response body after you start a journey from the Mint API.

API journey URL lifetime

The workflow settings configured in the Mint Builder do not affect the lifetime of URLs returned by the API. The lifetime of the returned URL is controlled exclusively by the journeyUrlTtl parameter in the API request body.

To control how long the journeyUrl remains valid, pass the journeyUrlTtl parameter (in seconds) in your request body to the Start journey endpoint. You can specify a value between 1 and 2592000 seconds (30 days). If you omit journeyUrlTtl, the URL expires after 60 seconds.

Example request body
{
"input": {},
"journeyUrlTtl": 3600
}

The endpoint returns the generated journeyUrl and the journeyId:

Example response
{
"journeyId": "f81d4fae-7dec-11d0-a765-00a0c91e6bf6",
"journeyUrl": "https://example.signicat.com/mint/journeys/f81d4fae-7dec-11d0-a765-00a0c91e6bf6?token=..."
}
Other ways to configure journey URLs
  • Active journeys: To generate a new return URL for an active journey, send a request to the Create journey URL (POST /journeys/{journeyId}/url) endpoint and set the timeToLive parameter (in seconds), or create a return URL from the Mint Journeys page in the Signicat Dashboard.
  • Workflow steps: When you start a flow from another flow using the Start journey step, set the Journey URL time to live input property to control the lifetime of the generated URL.

Return URLs​

You can configure temporary return URLs to direct your end-users back to an active user journey either in a step in the Mint Builder or directly in the Mint Journeys.

Return URLs in the Mint Builder​

Mint steps support return URLs in their configuration. To insert a return URL in a step. do the following:

  1. In the Mint Builder, select the step where you want to add the URL.
  2. In the step configuration, select an input field where to insert the link.
  3. Select the plus icon (+) inside the field, then select Workflow Variables > Return URL.

By default, return URLs have a lifetime of 60 seconds. You can customise this lifetime by using the Advanced mode.

To configure the lifetime of a return URL in a step:

  1. Open your flow in the Mint Builder and select a step where you want to include the return URL.

  2. In the step configuration menu, find the input field where you want to insert the URL.

  3. Select the plus icon (+) in the input field and choose Workflow Variables > Return URL.

  4. Select the Advanced icon above the input field to switch to Advanced mode. The field displays the Liquid tag {% workflowurl %}.

  5. Add the lifetime in seconds inside the tag, separated by a space. For example, to set the return URL lifetime to 1 hour (3600 seconds), enter:

    {% workflowurl 3600 %}
  6. Select Save at the top right to save your flow.

Return URLs in the Mint Journeys​

You can generate a temporary return URL directly from an active journey in Mint Journeys. This is useful when an end-user needs to resume a paused journey or reconnect after losing their session.

To generate a return URL from Mint Journeys, do the following:

  1. In the Signicat Dashboard, go to Products > Signicat Mint.
  2. In the left menu, select Journeys.
  3. Select an active journey from the list to open its details page.
  4. At the top right, select Create return URL.
  5. Optional. Set the URL lifetime in seconds. By default, this is 60 seconds, and you can set it to up to 30 days (2,592,000 seconds).
  6. Select Create to generate the URL and copy it to your clipboard.

To resume the journey in a new browser, do the following:

  1. Open a new browser window or tab.
  2. Paste the return URL into the address bar and press Enter.

The user journey opens directly at the step where it stopped, retaining all data submitted in earlier steps.

Next steps​

Continue your journey with Mint: