These changes are live on the REST API too, so apps that call the API directly are affected, not only apps that use the SDK. Check these five things.
What you need to do
- Paging. Lists take
limitandcursorand return{ items, nextCursor }. PassnextCursorback until it isnull.page,offset,totalandpaginationare gone. The CLI's--cursorreplaces--page, and--jsonprints{ items, nextCursor }. - Read models. Lists return summaries and
getreturns the full item. Read deliveries and bodies withmessages.listDeliveriesandmessages.getContent. On contacts,humanProfileis nowprofileand addresses live onidentities. Template bodies come fromtemplates.get. Conversations returncontactsinstead ofparticipants, andmetricsis gone. - Updates.
contacts.updateandconversations.updatechange only what you send. Use theadd*andremove*methods for identities, tags, categories and channels.metadatamerges by key, andnulldeletes a key. - Names. Methods take the resource identifier as
id, for examplewebhookIdis nowid. Date filters areafterandbefore, and the CLI's--afterand--beforereplace--start-date,--end-dateand--period.campaigns.archivereplaces delete,apiKeys.revokereplacesapiKeys.remove, andmessages.getEmailtakesincludeDownloadUrlsand returnsdownloadUrls. - Validation errors. An invalid request fails with
422 ValidationErrorand lists each bad field. Handle it where you handled other client errors.
The full list is in the package changelog.