Set KoboToolbox Form Sharing
kobo_set_sharingControl who can fill in or work on a form: enable anonymous public submission links, grant view/edit/manage access to collaborators, or revoke permissions.
Instructions
Control who can fill in a form and who can work on it.
Two independent things:
anonymous_submissions: makes the collect link usable by ANYONE who has it, with no Kobo account. This is what turns a deployed form into a genuinely public link. It never lets the public read the responses already collected — only submit new ones.
share_with / revoke_from: give or remove named collaborators' access to the form and its data.
Roles:
view: see the form and read its submissions
edit: also add and change submissions, and edit the form
manage: full control, including sharing it further
Args:
uid (string): asset uid of the form
anonymous_submissions (boolean, optional): true to publish, false to revoke
share_with: [{username, role}]
revoke_from: [usernames] — removes every permission that user holds
response_format ('markdown' | 'json')
Returns: the resulting access list, and the collect links when the form becomes public.
Examples:
"Make my form publicly fillable" -> anonymous_submissions=true
"Let Awa edit the data" -> share_with=[{username:"awa", role:"edit"}]
Notes:
Publishing a form is outward-facing: anyone with the URL can then submit. Confirm with the user before enabling it unless they asked.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uid | Yes | Asset uid of the form | |
| share_with | No | Grant collaborators access to the form | |
| revoke_from | No | Kobo usernames whose access should be removed entirely | |
| response_format | No | Output format: 'markdown' for human-readable or 'json' for machine-readable | markdown |
| anonymous_submissions | No | true makes the Enketo collect link usable by anyone without a Kobo account — this is what turns a deployed form into a genuinely public link. false revokes it. |