•••
 
Documentation   /   API   /   API - Stopping tasks
 
 

API - Stopping tasks

 

Endpoint

POST https://plainly.com/stop

Parameters

task
Required. Key of the relevant task being stopped. Can be obtained via the {{checklist_key}} variable.
key
Required. Workflow-specific API key. Obtained from the Developer tab for the relevant workflow in the Toolkit.
comment
Optional. Your reason why the task was stopped.

Example

Request

https://plainly.com/stop?task=a1b2c3d4a1b2c3d4&key=4d3c2b1a4d3c2b1a

On success

{
  "data": {
     "status": 200,
     "title": "Task stopped",
     "detail": "Customer no longer wishes to proceed."
   }
}

On error

{
  "errors": [
    {
      "status": 400,
      "title": "Missing attribute",
      "detail": "You need task and key parameters."
    }
  ]
}