Next step

Navigates to the next step of the journey, evaluating the actions (Actions to be Performed) and saving the data into the specific record.

Syntax

Copy 
POST <host_address>/ftosapi/digital-journeys/<digital_journey_name>/next/{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 
{
  "nextStep": {
    "journeyItem": "string",
    "journeyStep": "string"
  },
  "instanceId": "string",
  "externalId": "string"
}
 
Key Description
journeyItem The name of the form driven flow associated with the digital journey.

journeyStep

The name of the next step in the digital journey.

instanceId

The ID of the digital journey instance.
externalId The unique identifier of the digital journey.

Examples

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

  • https://app-portal-issue2441-rc.azurewebsites.net is the URL of the FintechOS server.
  • 10a32355-8d70-4131-a972-55c1e38d813e is the externalId (unique identifier) of the digital journey instance.
  • The request is successful and returns the name of the form driven flow associated with the digital journey (AdiFlowApi), and the name of the next step (CXdetails).

Request

Copy 
POST /ftosapi/digital-journeys/AdiDJapi/next/10a32355-8d70-4131-a972-55c1e38d813e 
Host: app-portal-issue2441-rc.azurewebsites.net
Content-Type: application/json

Response

Copy 
{
  "nextStep": {
    "journeyItem": "AdiFlowApi",
    "journeyStep": "CXdetails"
  },
  "instanceId": "10a32355-8d70-4131-a972-55c1e38d813e",
  "externalId": "10a32355-8d70-4131-a972-55c1e38d813e"
}

Errors

HTTP code Message

Context
404 Not Found No Digital Journey Instance Step found with status Loaded Occurs when the "Load" endpoint was not called beforehand.

400 Bad Request

Request contains duplicate values: {0}

The attribute/value pairs in the body contain duplicate entries (of attribute names).