Run Workflow API
Use this API to initiate the execution of a specific workflow. It allows triggering automated processes with input parameters.
Required Permissions
Following permissions are needed to run the workflow:
- EXECUTE ALL
- EXECUTE WF BY TAGS
- EXECUTE MY WF
Input ParametersInput Parameters
Parameter |
Mandatory/Optional |
Data Type |
Description |
---|---|---|---|
workflowId |
Mandatory |
String |
Provide a valid workflow ID. Ensure it is UUID. For example, '0ffaf046-768b-79fc-83f6-aa25be52c2a1' |
Request Body |
Optional |
JSON |
Provide a valid JSON object containing the input data to run the workflow. For example, { |
Authorization |
Mandatory |
String |
Authorization token to authenticate to the Qualys Cloud Platform. Prepend token with 'Bearer' and one space. For example - Bearer <authToken> |
Sample: Initiate execution of a workflowSample: Initiate execution of a workflow
API Request
curl -X POST '<qualys_base_url>/qflowapi/v1/workflows/f516bcf4-f6fb-46ac-a54f-ddbcf2a2d24a/run' -H "Accept: application/json" -H "Content-Type: application/json" -H "Authorization: Bearer <jwt token>"
Response
{ "data":{ "customerId":"54f50897-26f3-c9af-83f9-e71459be70d9", "workflowId":"f516bcf4-f6fb-46ac-a54f-ddbcf2a2d24a", "input":{ }, "executionId":"ee75301e-bbcf-4e7e-9cae-b6f99fc2060e", "forceRun":true, "overrideVariables":[ ], "source":"PUBLIC_API" } }