KoboToolbox Form Version History
kobo_form_versionsList deployed versions of a Kobo form and restore a previous one to fix issues; redeploying an older version restores the original structure while preserving collected data.
Instructions
List a form's deployed versions, and roll back to one of them.
Kobo keeps every version that was ever deployed. This is the way back when a change breaks a live form: redeploying a past version restores the old structure without touching the submissions already collected.
Args:
uid (string): asset uid of the form
rollback_to (string, optional): version uid to redeploy. Omit to only list the history.
limit (number, default 30): how many versions to list
response_format ('markdown' | 'json')
Returns: the version history (newest first) with deployment dates, and the resulting status after a rollback.
Notes:
Rolling back changes the form structure only. Answers collected under the newer version stay in the database, but fields that no longer exist drop out of exports.
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>"
},
"name": "kobo_form_versions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uid | Yes | Asset uid of the form | |
| limit | No | How many versions to list | |
| rollback_to | No | Version uid to redeploy. Omit to only list the version history. | |
| response_format | No | Output format: 'markdown' for human-readable or 'json' for machine-readable | markdown |