📢 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 are scheduled for full removal in the June 2026 release (deployment planned for June 2).

v1 endpoints are being phased out in favor of the more robust and fully supported KPI v2 API.
A support article is also available 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 DEPRECATION.md of the KPI GitHub repository includes 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!

1 Like
5

Hello everyone,

The README has been updated with a new section API Deprecation & Removal Notices.

The support article will be available soon. See below

1 Like
6

Hello everyone,

The support article is now available at Migrating from v1 to v2 API — KoboToolbox documentation.

Original post has been also updated.

2 Likes