Previous step

Navigates to the previous step of the journey. A record will be inserted in the FTOS_DJ_InstanceStep table.

Syntax

Copy 
POST <host_address>/ftosapi/digital-journeys/<digital_journey_name>/previous/{externalId} 
 
Parameter Description
host_address The URL of the FintechOS platform server.
digital_journey_name The name of the digital journey.
externalId The unique identifier of the digital journey.

Response

Copy 
{
  "instanceId": "string",
  "externalId": "string",
  "nextStep": {
    "journeyItem": "string",
    "journeyStep": "string"
  }

Examples

In this example, we go to the previous step in our digital journey.

  • https://app-idp-mytestbank1-uat.azurewebsites.net is the URL of the FintechOS server.
  • f840a49d-bee5-44bb-902a-184987f082a1 is the externalId (unique identifier) of the digital journey.
  • The request is successful and returns the name of the ongoing form driven flow (OvdBankFLOW), and the name of the previous step (Start).

Request

Copy 
POST /Portal/ftosapi/digital-journeys/Oi_DJF/previous/f840a49d-bee5-44bb-902a-184987f082a1
Host: https://app-idp-mytestbank1-uat.azurewebsites.net/
Content-Type: application/json

Response

Copy 
{
  "nextStep": {
    "journeyItem": "OvdBankFLOW",
    "journeyStep": "Start"
  },
  "instanceId": "f840a49d-bee5-44bb-902a-184987f082a1",
  "externalId": "f840a49d-bee5-44bb-902a-184987f082a1"
}

Errors

HTTP code Message

Context
404 Not Found The first step does not have Previous Step Occurs when trying to make a previous request on the first step.
404 Not Found

No Digital Journey Instance Step found with status Loaded

Occurs when the "Load" endpoint was not called beforehand.