Set Validation Status on Submissions
kobo_validate_submissionsClean survey responses by marking Kobo submissions as approved, not approved, or on hold while retaining rows for review.
Instructions
Mark submissions as approved, not approved, or on hold — Kobo's data-cleaning workflow.
This is the non-destructive way to handle suspect responses: the row stays in the database and in exports, carrying its status, instead of being deleted.
Args:
uid (string): asset uid of the form
submission_ids (array of strings): the "_id" values to mark
status: 'validation_status_approved' | 'validation_status_not_approved' | 'validation_status_on_hold'
Returns: how many submissions were updated.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"uid": "<uid>",
"submission_ids": "<submission_ids>",
"status": "<status>"
},
"name": "kobo_validate_submissions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uid | Yes | Asset uid of the form | |
| status | Yes | Validation status to apply, as shown in Kobo's data table | |
| submission_ids | Yes | Ids of the submissions to mark |