WavefrontDevelopers

Reference

Changelog and versioning

Changes to the REST API and the MCP server that integrations should know about.

2026-10-12

The public developer docs launch, describing the API and MCP server as they are today:

  • REST API at https://wavefront.adwave.com/v1, with an OpenAPI 3.1 document that names every operation (operationId), groups it by tag, gives the API key scope it needs (x-required-scope), marks web-app-only operations (x-session-only) and describes every event webhook.
  • Workspace API keys with seven scopes: generations:read, generations:write, publish, context:read, context:write, context:git-sync (legacy) and webhooks.
  • MCP server at https://wavefront.adwave.com/mcp (Streamable HTTP, OAuth 2.1 with dynamic client registration, client ID metadata documents and PKCE), where every tool has a title and read-only, destructive, idempotent and open-world hints.
  • Event webhooks signed with Standard Webhooks, with a delivery log, redelivery and secret rotation.
  • Hosts: https://wavefront.adwave.com is the home of the API and MCP server. Integrations set up on wavefront.adwave-apps.com keep working.

Versioning policy

The REST API is versioned in its path. /v1 is a contract:

  • Additive changes can ship at any time, without notice: new operations, new optional request fields and query parameters, new response fields, new event types, new error codes for new situations, and new values in lists such as destination types. Write clients that ignore fields they don't know and handle unknown enum values.
  • Breaking changes get a new version and notice: removing or renaming a field or operation, changing a field's type or meaning, or making an optional input required. They ship under a new path such as /v2, announced here ahead of time, while /v1 keeps working.
  • Error code values are stable; message and hint wording can change at any time.
  • MCP tools follow the same rule: new tools and new optional inputs can appear at any time; a tool is not removed or changed incompatibly without notice.

Questions about a change: support@adwave.com.