Bulk approve, reject, or revert form element submissions
FormElementSubmission
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 elementformSubmissionId: 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.
PATCH
Bulk approve, reject, or revert form element submissions
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
application/json

