Delete KoboToolbox Submissions
kobo_delete_submissionsPermanently delete specific form submissions after confirmation. Use to remove test entries, duplicates, or responses respondents asked to withdraw. Cannot be undone.
Instructions
Permanently delete specific submissions from a form. THIS CANNOT BE UNDONE.
Use it to remove test entries, duplicates, or a response a respondent asked to withdraw.
Args:
uid (string): asset uid of the form
submission_ids (array of strings): the "_id" values from kobo_list_submissions
confirm (true): must be explicitly set to true
Don't use when: you want to discard a whole form's data — that is kobo_delete_form. To merely flag bad rows while keeping them, use kobo_validate_submissions with 'not approved' instead.
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>",
"confirm": "<confirm>"
},
"name": "kobo_delete_submissions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uid | Yes | Asset uid of the form | |
| confirm | Yes | Must be true — deleted submissions cannot be recovered | |
| submission_ids | Yes | Ids of the submissions to permanently delete |