[Workflow] Add purge/pause/resume/raise event to docs

daprdocs/content/en/developing-applications/building-blocks/workflow/howto-manage-workflow.md

@@ -56,6 +56,29 @@ To terminate your workflow with an ID `12345678`, run:
 POST http://localhost:3500/v1.0-alpha1/workflows/dapr/12345678/terminate
 ```
 
+### Pause or resume a workflow
+
+To plan for down-time, wait for inputs, and more, you can pause and then resume a workflow. To stop a workflow with an ID `12345678` until triggered to resume, run:
+
+```bash
+POST http://localhost:3500/v1.0-alpha1/workflows/dapr/12345678/pause
+```
+
+To resume a workflow with an ID `12345678`, run:
+
+```bash
+POST http://localhost:3500/v1.0-alpha1/workflows/dapr/12345678/resume
+```
+
+
+### Purge a workflow 
+
+To remove actor state from your state store and avoid overloading your state stores, run:
+
+```bash
+POST http://localhost:3500/v1.0-alpha1/workflows/dapr/OrderProcessingWorkflow/purge
+```
+
 ### Get information about a workflow
 
 To fetch workflow information (outputs and inputs) with an ID `12345678`, run:

daprdocs/content/en/reference/api/workflow_api.md

@@ -90,6 +90,112 @@ Traceparent: 00-e3dedffedbeb9efbde9fbed3f8e2d8-5f38960d43d24e98-01
 Connection: close 
 ```
 
+## Pause workflow request
+
+Pause a running workflow instance with the given name and instance ID.
+
+```bash
+POST http://localhost:3500/v1.0-alpha1/workflows/<workflowComponentName>/<instanceId>/pause
+```
+
+### URL parameters
+
+Parameter | Description
+--------- | -----------
+`workflowComponentName` | Current default is `dapr` for Dapr Workflows
+`instanceId` | Unique value created for each run of a specific workflow
+
+### HTTP response codes
+
+Code | Description
+---- | -----------
+`202`  | Accepted
+`400`  | Request was malformed
+`500`  | Request formatted correctly, error in dapr code or underlying component
+
+### Response content
+
+The API call will provide a response similar to this:
+
+```bash
+HTTP/1.1 202 Accepted
+Server: fasthttp
+Date: Thu, 12 Jan 2023 21:31:16 GMT
+Traceparent: 00-e3dedffedbeb9efbde9fbed3f8e2d8-5f38960d43d24e98-01
+Connection: close 
+```
+
+## Resume workflow request
+
+Resume a paused workflow instance with the given name and instance ID.
+
+```bash
+POST http://localhost:3500/v1.0-alpha1/workflows/<workflowComponentName>/<instanceId>/resume
+```
+
+### URL parameters
+
+Parameter | Description
+--------- | -----------
+`workflowComponentName` | Current default is `dapr` for Dapr Workflows
+`instanceId` | Unique value created for each run of a specific workflow
+
+### HTTP response codes
+
+Code | Description
+---- | -----------
+`202`  | Accepted
+`400`  | Request was malformed
+`500`  | Request formatted correctly, error in dapr code or underlying component
+
+### Response content
+
+The API call will provide a response similar to this:
+
+```bash
+HTTP/1.1 202 Accepted
+Server: fasthttp
+Date: Thu, 12 Jan 2023 21:31:16 GMT
+Traceparent: 00-e3dedffedbeb9efbde9fbed3f8e2d8-5f38960d43d24e98-01
+Connection: close 
+```
+
+## Purge workflow request
+
+Purge a running workflow instance with the given name and instance ID.
+
+```bash
+POST http://localhost:3500/v1.0-alpha1/workflows/<workflowComponentName>/<instanceId>/purge
+```
+
+### URL parameters
+
+Parameter | Description
+--------- | -----------
+`workflowComponentName` | Current default is `dapr` for Dapr Workflows
+`workflowName` | Identify the workflow type
+`instanceId` | Unique value created for each run of a specific workflow
+
+### HTTP response codes
+
+Code | Description
+---- | -----------
+`202`  | Accepted
+`400`  | Request was malformed
+`500`  | Request formatted correctly, error in dapr code or underlying component
+
+### Response content
+
+The API call will provide a response similar to this:
+
+```bash
+HTTP/1.1 202 Accepted
+Server: fasthttp
+Date: Thu, 12 Jan 2023 21:31:16 GMT
+Traceparent: 00-e3dedffedbeb9efbde9fbed3f8e2d8-5f38960d43d24e98-01
+Connection: close 
+```
+
 ### Get workflow request
 
 Get information about a given workflow instance.