docs: add code examples to migrating_api article#540
Open
noliveleger wants to merge 2 commits into
Open
Conversation
jnm
reviewed
May 19, 2026
|
|
||
|
|
||
| As part of our ongoing efforts to streamline and modernize the KoboToolbox platform, we are phasing out KPI and KoboCAT `v1` endpoints. All KPI and KoboCAT `v1` endpoints are now deprecated, and will be removed entirely in June 2026. `v1` endpoints are being phased out in favor of the more robust and fully supported KPI `v2` API. | ||
|
|
Member
There was a problem hiding this comment.
The stated purpose of this article is explaining "how to migrate your API integrations", but we lack any way to educate the readership (which is large because we published an in-app message linking here) as to whether this information applies to them at all.
Perhaps we should include a section to help people, even extremely non-technical people who will have clicked an important-looking link and ended up here, understand if they will actually be affected in any way.
We should further guide people to our articles about using synchronous exports to connect to common platforms, such as:
- https://support.kobotoolbox.org/pulling_data_into_excelquery.html
- https://support.kobotoolbox.org/pulling_data_into_powerbi.html
Integrations using synchronous exports will NOT need any modification; they are totally fine as-is!
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
#### Code examplesbefore#### Response examplesfor faster scanning<details>blocks to reduce visual noise