Interna
Resources

Migration Guide

Step-by-step guide for migrating from v1 to v2 of the Interna API.

What's Changed

  • Authentication header format changed from X-Api-Key to Bearer tokens
  • Pagination switched from offset-based to cursor-based
  • User ID prefix changed from user_ to usr_
  • Webhook payload format now includes a meta envelope

Migration Steps

  • Update your SDK to version 2.x: npm install @interna/sdk@latest
  • Replace X-Api-Key headers with Authorization: Bearer headers
  • Update any stored user IDs to the new prefix format
  • Test webhook handlers against the new payload format
  • Run your integration test suite before deploying