---
updatedAt: 2026-04-30T16:58:50.000Z
agentTools:
  projectIndex: https://developer.trulioo.com/llms.txt
---

# Generate Signed URL for User Session

Signed URLs let you launch authenticated Workflow Studio workflows via secure, one‑time links instead of a generic public URL.

To use them, publish your flow as an authenticated hosted experience and generate a signed link per end user via the signed-url API endpoint. Each link is unique and tied to a specific workflow and end client, preventing link‑sharing, brute‑forced session IDs, and large‑scale fraudulent completions while still giving you a low‑code, hosted experience.

The signed URL token itself is an opaque, base64‑encoded token. The entire signed URL will never exceed 256 characters.

<br />

Generate a new signed URL with a valid token for the provided flow, which can be used for future authorized calls for operations on the user state ID. This operation creates a new user state ID if no end client ID is provided.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Trulioo Platform API",
    "description": "# Introduction\nThe Trulioo Platform is used to create fast and compliant onboarding flows. The flow can be published from the dashboard in the Launcher page.\n\n### Purpose\nOur new API helps you take advantage of our flow builder and access our catalog of KYC services. Build the flow that fits your requirements thanks to our no-code platform, embed it into your application, and onboard all your end-clients seamlessly, Trulioo Platform takes care of the rest. The orchestration document provides a flow execution API.\n\n### Key features\nThe Trulioo Platform API grants control of the flow execution and user state to the client. The user state is associated with a session id (x-hf-session). See the diagram below for an overview of the integration.\n\n<img src=\"https://internal.workflow.dev.trulioo.com/api-docs/src/workflow_studio_diagram.jpg\" alt=\"workflow studio diagram\"  />",
    "termsOfService": "",
    "contact": {
      "name": "Customer Support",
      "url": "",
      "email": "support@trulioo.com"
    },
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.trulioo.com/wfs/interpreter-v2/"
    }
  ],
  "security": [],
  "tags": [
    {
      "name": "Using the API",
      "description": "Four most important API Calls are:\n- Initialize\n- Submit data\n- Retrieve profile data from a client\n- Client Credential flow\n\n### Other end points\n1. *FlowStep operation*\n\n   Requests data about the current state of a user in the flow. Creates a state if none is provided by returning a Header (x-hf-session) which represents a session ID. If the header is passed in the request, the operation will return the step response according to the flow execution state, otherwise, it will generate a session and initialize the flow from the first step.\n2. *SubmitStep operation*\n\n   Submits data - triggers the execution of the current step, modifies the state with the data provided, and returns the next step in the flow. The flow execution always ends with an END step even if it is not added to the flow.\n\n3. *getBackStep operation*\n\n   Returns to the previous step in the flow - computes a backward step in the flow. Multiple backward steps can be performed until the root (first) step of the flow. Non-interactive services are re-executed if they exist between a backward and a forward step.\n\n### Other Considerations\n- Flow steps defined in the builder may not coincide with the orchestration flow of execution. This can occur due to non-interactive services which are triggered in the background and condition logic which creates mutually exclusive reachable paths.\n- Some services can take a long time to execute and will return a pending state rather than wait until the next step is computed. In this case, you can call FlowStep repeatedly until you get the next step.\n- Field ids in the client form are automatically generated, therefore, we suggest implementing dynamic field mapping between the form and WF API.\n- To test version of a flow rather than the live (published) version, prefix the endpoint path with /test.\n- Flows can be published as authenticated using the flow builder UI. By restricting integration access exclusively to the Trulioo Platform API, this action enhances security and enables a regulated interaction with your flow.\n- National ID and Social service number may have different names based on country. When applicable, a tooltip is added next to the field with the proper name based on the country chosen.\n\n### Resources\n- For more comprehensive information and details on the authentication process, refer to: <a href='https://developer.trulioo.com/docs/keys-and-authentication' target='_blank'>https://developer.trulioo.com/docs/keys-and-authentication</a>.\n- Please refer to the following resource for more information about the National ID and Social service number tooltips: <a href='https://developer.trulioo.com/docs/national-ids-supported-types' target='_blank'>https://developer.trulioo.com/docs/national-ids-supported-types</a>. Note: not entering information for the correct National ID or Social service number type based on the country selected may lead to failed identification.\n- If you encounter any issues or have further questions, reach out to our support team for assistance.\n"
    }
  ],
  "paths": {
    "/signed-url/{flowId}": {
      "post": {
        "tags": [
          "Using the API"
        ],
        "summary": "Generate Signed URL for User Session",
        "operationId": "signed_url",
        "parameters": [
          {
            "name": "flowId",
            "in": "path",
            "description": "The ID of the flow",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "endClientId",
            "in": "query",
            "description": "ID for a user state in the execution flow (generated in the first interaction with a flow).\n\nWhen endClientId is used, the provided user state will be updated. If no endClientId is provided, a new user state ID is created and returned",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Returns the new x-hf-session created or the same one if provided in the x-hf-session",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateSignedUrlResponse"
                }
              }
            }
          },
          "400": {
            "description": "Client provided invalid data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Invalid token provided"
          },
          "500": {
            "description": "Internal server error (which might be caused by a temporary issue)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "Error message"
          },
          "code": {
            "type": "integer",
            "description": "Internal API error code",
            "format": "int32"
          }
        }
      },
      "CreateSignedUrlResponse": {
        "type": "object",
        "properties": {
          "signedUrl": {
            "type": "string",
            "description": "The generated URL"
          },
          "endClientId": {
            "type": "string",
            "description": "The ID of the end client for which the URL was generated"
          }
        }
      }
    }
  }
}
```