Complete steps

Complete steps in the app or using the API

Completing a form or decision step in the app

A form step is completed when you have finished all the form fields and click the Complete button under the form. That also applies to decision steps, where you select your decision and click Complete.

🚧

You can edit a completed step as long as the workflow instance is still in progress. However, if conditional steps follow, and they have already been completed, the updates to the form step won't affect the completed conmditions.

Completing an automated step

Those steps do not need your input and are completed automatically. If an automated step produces an error, the workflow technical lead is notified by email and can update and restart the step.

Completing steps using API

You can also use our API to complete steps.

Use the following information to structure your calls:

Field with a simple input form field

{
   "step_id":"STEP_ID",
   "actions":[
      {
         "FORM_FIELD_ID":"FORM_FIELD_ID",
         "input_object":{
            "inputValue":"STRING"
         }
      }
   ]
}

Field with an address input

{
   "step_id":"STEP_ID",
   "actions":[
      {
         "input_object":{
            "inputValue":{
               "city":"city",
               "street":"street",
               "zipCode":"zipCode"
            }
         },
         "action_id":"FORM_FIELD_1_ID"
      }
   ]
}

Field with a date input

{
   "step_id":"STEP_ID",
   "actions":[
      {
         "input_object":{
            "date":"2021-06-16T10:00:00.000Z"
         },
         "action_id":"FORM_FIELD_1_ID"
      }
   ]
}

Field with a checklist

{
   "step_id":"STEP_ID",
   "actions":[
      {
         "input_object":{
            "inputValue":{
               "itemsChecked":[
                  "Option A", //enter only one value for single selection
                  "Option B"
               ],
               "itemsNotChecked":[
                  "Option B",//If you want to select multiple values and leave only few options unselected, specify the options to leave unchecked and the remaining options will be checked by default
                  "Option C"
               ]
            }
         },
         "action_id":"FORM_FIELD_1_ID"
      }
   ]
}

Field with radio button selection

{
   "step_id":"STEP_ID",
   "actions":[
      {
         "input_object":{
            "inputValue":{
               "radioItemSelected":"Option A"
            }
         },
         "action_id":"FORM_FIELD_1_ID"
      }
   ]
}

Field with URL input

{
   "step_id":"STEP_ID",
   "actions":[
      {
         "input_object":{
            "url":{
               "url":"http://nextmatter.com"
            }
         },
         "action_id":"FORM_FIELD_1_ID"
      }
   ]
}

Filed with email input

{
    "step_id": "STEP_ID",
    "actions": [
        {
            "input_object": {
                "emailValue": "[email protected]"
            },
            "action_id": "FORM_FIELD_1_ID"
        }
    ]
}

Field with user selection dropdown

{
   "step_id":"STEP_ID",
   "actions":[
      {
         "input_object":{
             "selection":{
                 "user_email":"[email protected]"
               }  
         },
         "action_id":"FORM_FIELD_1_ID"
      }
   ]
}

Field with user selection dropdown (team as assignee)

{
    "step_id": "STEP_ID",
    "actions": [
        {
            "input_object": {
                "selection": {
                    "team_id": 1234 //If the assignee is a team, you need to enter the Team ID. Contact our Support Team to get the ID. //
                }
            },
            "action_id": "FORM_FIELD_1_ID"
        }
    ]
}

Instruction

{
   "step_id":"STEP_ID",
   "actions":[
      {
         "input_object":{
            "inputValue":{}//An instruction field doesn't require any input but still needs to be completed. That's why we recommend entering an empty input object.
         }
         },
         "action_id":"FORM_FIELD_1_ID"
      }
   ]
}

Routing

Return to step

{
  "step_id": <ACTIVE_STEP_ID>,
  "actions": [
    {
      "action_id": FORM_FIELD_1_ID,
      "input_object": {
        "action": "return",
        "comment": "comment_text", //leave as "" if there's no comment
        "returnToStep": <STEP_TO_RETURN_TO_ID>
      }
    }
  ]
}

Skip forward (to step)

{
  "step_id": <ACTIVE_STEP_ID>,
  "actions": [
    {
      "action_id": FORM_FIELD_1_ID,
      "input_object": {
        "action": "skip_forward",
        "comment": "comment_text", //leave as "" if there's no comment
        "returnToStep": <STEP_TO_SKIP_TO_ID>
      }
    }
  ]
}

Stop instance

 {
  "step_id": <ACTIVE_STEP_ID>,
  "actions": [
    {
      "action_id": FORM_FIELD_1_ID,
      "input_object": {
        "action": "decline",
        "comment": "comment_text", //leave as "" if there's no comment
        "returnToStep": -2
      }
    }
  ]
}

Continue

 {
  "step_id": <ACTIVE_STEP_ID>,
  "actions": [
    {
      "action_id": FORM_FIELD_1_ID,
      "input_object": {
        "action": "complete",
        "comment": "comment_text", //leave as "" if there's no comment
        "returnToStep": -1
      }
    }
  ]
}

Decision step (legacy)

{
   "step_id":"STEP_ID",
   "actions":[
      {
         "action_id":"FORM_FIELD_ID",
         "input_object":{
            "comment":"COMMENT",
            "decision":"return"//other options are: continue or decline
         }
      }
   ]
}