Approve, reject, or revert a specific form element submission.
Note: For ACTIVITY elements, this action applies to all submissions for the same form element and period within the same form submission (site + year), ensuring consistent status across multiple activity rows in that period.
Workflow Actions:
approve: Sets the submission status to “APPROVED”reject: Sets the submission status to “REJECTED”revert: Sets the submission status back to “COMPLETED” (pending approval)Permission Requirements:
Parameters:
formElementSubmissionId: The unique identifier of the form element submission to approve/reject/revertaction: One of “approve”, “reject”, or “revert”reason: Optional reason for the approval/rejection/revert actionThis endpoint is essential for workflow management and quality control in data collection processes.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Successful response
COMPLETED, APPROVED, REJECTED