Bulk approve, reject, or revert form element submissions

Bulk approve, reject, or revert all form element submissions for a specific form element within a form submission (site + year scope).

Workflow Actions:

• approve: Sets all eligible submissions status to “APPROVED”
• reject: Sets all eligible submissions status to “REJECTED”
• revert: Sets all eligible submissions status back to “COMPLETED” (pending approval)

Scope: Only affects submissions for the specified form element within the current form submission (site + year combination).

Permission Requirements:

• User must have APPROVER, MANAGER, or OWNER role in the organization
• User must have access to the site where the form is deployed
• The form element must belong to the user’s organization

Parameters:

• formElementId: The unique identifier of the form element
• formSubmissionId: The unique identifier of the form submission (scopes to specific site + year)
• action: One of “approve”, “reject”, or “revert”
• reason: Optional reason for the bulk approval/rejection/revert action

Eligible Submissions:

• For “approve”: Only COMPLETED or REJECTED submissions will be approved
• For “reject”: Only COMPLETED or APPROVED submissions will be rejected
• For “revert”: Only APPROVED or REJECTED submissions will be reverted to COMPLETED

This endpoint is ideal for workflow management when you need to approve/reject/revert multiple period submissions (monthly, quarterly) for a form element at once.