{ "opencollection": "1.0.0", "info": { "name": "Knock Audiences Workflows API", "version": "1.0" }, "request": { "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "items": [ { "info": { "name": "Workflows", "type": "folder" }, "items": [ { "info": { "name": "Trigger workflow", "type": "http" }, "http": { "method": "POST", "url": "https://api.knock.app/v1/workflows/:key/trigger", "params": [ { "name": "key", "value": "", "type": "path", "description": "Key of the workflow to trigger." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Trigger a workflow (specified by the key) to run for the given recipients, using the parameters provided. Returns an identifier for the workflow run request. All workflow runs are executed asynchronously. This endpoint also handles [inline identifications](/managing-recipients/identifying-recipients#inline-identifying-recipients) for the `actor`, `recipient`, and `tenant` fields." }, { "info": { "name": "Cancel workflow", "type": "http" }, "http": { "method": "POST", "url": "https://api.knock.app/v1/workflows/:key/cancel", "params": [ { "name": "key", "value": "", "type": "path", "description": "The key of the workflow to cancel." } ], "body": { "type": "json", "data": "{}" } }, "docs": "When invoked for a workflow using a specific workflow key and cancellation key, will cancel any queued workflow runs associated with that key/cancellation key pair. Can optionally be provided one or more recipients to scope the request to." } ] } ], "bundled": true }