• What is Integration Server?
• Getting Started
  • Session management
  • Versioned calls
  • Interface versioning
  • Licensing
  • Unicode data
• Operations
• Reference
  • Data types
  • Request headers
  • Response headers
  • Errors
• History
  • Changelog
  • Version lookup

Versioned calls

Some Integration Server calls are versioned for reasons that include adding, removing, or changing data types, and more. For example, version 2 of the GET: /captureProfile call adds a categoryType query parameter.

You can tell the version number of a call by reviewing its request URL. For example, version 2 of /captureProfile/{id} is /v2/captureProfile/301YV77_0001EF54P000001, with "v2" meaning version 2.

If there is no version indicated by the request URL, you can assume that it is version 1 of the call.

When sending calls, it is best to enter a version number, even if you're using version 1 of a call. For example, /v1/captureProfile/301YV77_0001EF54P000001 is preferable to /captureProfile/301YV77_0001EF54P000001.