📢 Deprecation Notice: KoboToolbox V1 API Endpoints

Announcements
1

As part of our ongoing efforts to streamline and modernize the KoboToolbox platform, we are phasing out KPI and KoboCAT v1 endpoints.

:warning: All KPI and KoboCAT v1 endpoints will be removed entirely in January 2026.

v1 endpoints are being phased out in favor of the more robust and fully supported KPI v2 API. A new support article will be available soon to guide users through the migration from KoboCAT v1 to KPI v2.

Beginning August 01, 2025, we are deprecating the following v1 API endpoints:

:small_blue_diamond: KoboCAT v1 API (e.g.: https://kc.kobotoolbox.org/, https://kc-eu.kobotoolbox.org/)

  • /api/v1/forms
  • /api/v1/data
  • /api/v1/media
  • /api/v1/metadata
  • /api/v1/notes
  • /api/v1/submissions
  • /api/v1/user

:small_blue_diamond: KPI v1 API (e.g.: https://kf.kobotoolbox.org/, https://eu.kobotoolbox.org/)

  • /assets/ and all nested endpoints
  • /asset_snapshots/
  • /asset_subscriptions/
  • /exports/
  • /imports/
  • /permissions/
  • /reports/

:play_button: The README for the next release of the KPI GitHub repository will include detailed mappings from v1 endpoints to their new equivalent KPI v2 endpoints.

We strongly encourage all developers and users with integrations to update their systems as soon as possible to avoid disruption. The v1 endpoints will be completely discontinued in January 2026; after that date, requests to the deprecated v1 endpoints will fail.

4 Likes
2

Thanks for sharing,

As we are 7 days to that date, many of us might not get the chance to update our scripts.
Considering that the migration document is not available yet, would it be possible to postpone the deprecation of the v1 API endpoints for at least 1 month?

Thanks

3

Hello @nicopace,

Thank you for your message.

When we say deprecated, we mean that the endpoints will remain available and functional for now, but they are no longer supported. This means we won’t provide any maintenance, bug fixes, or improvements for them. They are scheduled for removal in January 2026, which gives users 5 months to migrate to the new endpoints. :wink:

We’re planning to publish new help articles and migration documentation in early August to assist with the transition.

I hope this makes things clearer.

2 Likes
4

Thanks for the clarification!
Will be looking for those migration articles.

Thanks!