Skip to main content

Bulk-assign workflows to one or more users

POST 
/monitoring-workflows/assignments

Distributes multiple monitoring workflows evenly across the provided user IDs using round-robin assignment. Use this endpoint to assign many workflows in a single call instead of one at a time via POST /monitoring-workflows/{id}/assignment. The request body must supply either workflowIds or filter to identify which workflows to assign — at least one is required. Workflows currently in REVIEWED_BY_CERTIFYOS status are automatically excluded from assignment and appear in the response failed array. Requires one of: MONITORING_WORKFLOW_ASSIGN, MONITORING_WORKFLOW_ASSIGN_SELF, or MONITORING_WORKFLOW_BULK_ASSIGN. The tenant-id header is mandatory. Always returns HTTP 200, even when every individual assignment fails — check the successful and failed arrays for per-workflow outcomes.

Request​

Responses​

Bulk assignment completed. successful/failed are arrays of {workflowId, assignment: {assignedTo, assignedBy, assignedAt}, error} — assignment is populated on success, error on failure. totalProcessed, successCount, and failureCount summarize the batch.