Workflows

Use workflows to automate multi-step processes

The Workflow Execution object

A Workflow Execution represents an instance of a workflow run triggered by your backend or frontend application. You can run workflows on a Transactionlink-hosted page, embed the form in your app, or execute them entirely in the background.

Use this object to initialize the flow, pass context, and retrieve completion status via webhooks or polling.

We recommend creating a new execution each time a user starts a workflow, to ensure that the flow is fresh and state is isolated for every attempt.

Initialise a new workflow execution

post

https://api.sandbox.transactionlink.iohttps://api.transactionlink.io

/workflows

Initialise a new workflow execution

Authorizations

bearerAuthJWT

Header parameters

AuthorizationstringRequired

Bearer token for authentication

Example: Bearer eyJhbGciOiJub25lIn0.eyJ3b3Jrc3BhY2VJZCI6ImRmYjI0ODU5LTA0OWUtNDcwZi1hNjY5LThhNzE0ZmYzNjU2YyIsICJpYXQiOjE3NTY3Mzc3MzIsICJleHAiOjE3NTY3NDEzMzIsICJjdXN0b206dGVhbUlkIjoiZjM1ZmVhZmYtNmI5OS00YWJkLTg0ZWItMjI3MDg0MzM1NDMyIn0.

Content-TypestringRequired

Content type of the request - application/json

Example: application/json;charset=UTF-8

Body

application/json;charset=UTF-8

workflowDefinitionIdstringRequired

Identifier of the workflow definition to execute

localestringRequired

Locale for the workflow execution, e.g., 'en', 'fr'

parametersobjectRequired

Key-value pairs of parameters required for the workflow execution

expiresAtstring | nullableOptional

Optional expiration date-time for the workflow execution in ISO 8601 format. Must be between 30 minutes and 30 days from the current time

recordIduuid | nullableOptional

Optional recordId this workflow refers to

Responses

200

200

application/json;charset=UTF-8

Responseone of

or

400

Bad Request – invalid request parameters

application/json

401

Unauthorized – JWT token missing or invalid

application/json

403

Forbidden – insufficient permissions

application/json

404

Not Found – resource does not exist

application/json

500

Internal Server Error – unexpected server error

application/json

post

/workflows

HTTPcURLJavaScriptPython

POST /workflows HTTP/1.1
Host: api.sandbox.transactionlink.io
Authorization: text
Content-Type: application/json;charset=UTF-8
Accept: */*
Content-Length: 143

{
  "workflowDefinitionId": "0940b863-eb4e-471a-8ae4-40a24b889e03",
  "locale": "uk",
  "parameters": {},
  "recordId": "00000000-0000-0000-0000-000000000001"
}

{
  "id": "e3c23802-537d-4aa4-89f1-397c120f5565",
  "workspaceId": "dfb24859-049e-470f-a669-8a714ff3656c",
  "workflowDefinitionId": "0940b863-eb4e-471a-8ae4-40a24b889e03",
  "parameters": {},
  "name": "workflow-name",
  "revision": "abc",
  "status": "RUNNING",
  "locale": "uk",
  "expiresAt": "2025-09-01T15:42:12.820469Z",
  "uiOptions": {},
  "recordId": "00000000-0000-0000-0000-000000000001",
  "executionType": "BACKGROUND",
  "executionVersion": 1,
  "origin": {
    "workspaceId": "81b016ab-87a1-4ac3-9da0-0ec084ee10c1",
    "type": "API"
  }
}

Find a workflow execution by its ID

get

https://api.sandbox.transactionlink.iohttps://api.transactionlink.io

/workflows/{workflowId}

Find a workflow execution by its ID

Authorizations

bearerAuthJWT

Path parameters

workflowIdstringRequired

Unique identifier of the workflow execution to retrieve

Header parameters

AuthorizationstringRequired

Bearer token for authentication

Example: Bearer eyJhbGciOiJub25lIn0.eyJ3b3Jrc3BhY2VJZCI6IjNjNjdjZWNhLTU1OTctNGIyZi05OTcxLWMyZGY0NWFkYzY1NyIsICJpYXQiOjE3NTY3Mzc3MzIsICJleHAiOjE3NTY3NDEzMzIsICJjdXN0b206dGVhbUlkIjoiODVmMDU3OTctNjE1OS00Yjk1LWI4MmItNWUzZDgxYTY3Yzc0In0.

Responses

200

200

application/json;charset=UTF-8

400

Bad Request – invalid request parameters

application/json

401

Unauthorized – JWT token missing or invalid

application/json

403

Forbidden – insufficient permissions

application/json

404

Not Found – resource does not exist

application/json

500

Internal Server Error – unexpected server error

application/json

get

/workflows/{workflowId}

HTTPcURLJavaScriptPython

GET /workflows/{workflowId} HTTP/1.1
Host: api.sandbox.transactionlink.io
Authorization: text
Accept: */*

{
  "id": "f01fd001-1456-426f-b8a1-972bc1d6218b",
  "workspaceId": "3c67ceca-5597-4b2f-9971-c2df45adc657",
  "workflowDefinitionId": "121ecef8-76c0-4100-a845-a4350679e08a",
  "parameters": {},
  "name": "workflow-name",
  "revision": "abc",
  "status": "RUNNING",
  "locale": "uk",
  "expiresAt": "2025-09-01T15:42:12.548500Z",
  "uiOptions": {},
  "executionType": "BACKGROUND",
  "executionVersion": 1,
  "origin": {
    "workspaceId": "3c67ceca-5597-4b2f-9971-c2df45adc657",
    "type": "API"
  }
}

Cancel a running workflow execution

post

https://api.sandbox.transactionlink.iohttps://api.transactionlink.io

/workflows/{workflowId}/cancel

Cancel a running workflow execution

Authorizations

bearerAuthJWT

Path parameters

workflowIdstringRequired

Unique identifier of the workflow execution to cancel

Header parameters

AuthorizationstringRequired

Bearer token for authentication

Example: Bearer eyJhbGciOiJub25lIn0.eyJ3b3Jrc3BhY2VJZCI6IjJiZDk3OGNlLTk1OGMtNDU3NS05NTUwLTFhMTk5MmUwYTYzOSIsICJpYXQiOjE3NTY3Mzc3MzMsICJleHAiOjE3NTY3NDEzMzMsICJjdXN0b206dGVhbUlkIjoiMjYyNTY0YjUtZjk5ZS00NTk0LTk4YTAtM2Y0MDQxMmQ4Y2FiIn0.

Responses

200

200

No content

400

Bad Request – invalid request parameters

application/json

401

Unauthorized – JWT token missing or invalid

application/json

403

Forbidden – insufficient permissions

application/json

404

Not Found – resource does not exist

application/json

500

Internal Server Error – unexpected server error

application/json

post

/workflows/{workflowId}/cancel

HTTPcURLJavaScriptPython

POST /workflows/{workflowId}/cancel HTTP/1.1
Host: api.sandbox.transactionlink.io
Authorization: text
Accept: */*

No content