Which API version supported on controller?

Is there a way to determine a relationship between the controller version and the API version that is supported by it?

For example, the most recent documentation of the client API reference shows Ziti Edge Client (0.26.39):

-Edge Client API Reference | OpenZiti

This API supports a list ext-jwt-signers endpoint:

However, when attempting to use this endpoint on the the latest controller v1.3.3 I get:

{
  "error": {
    "cause": {
      "code": "UNHANDLED",
      "message": "path /edge/client/v1/ext-jwt-signers was not found"
    },
    "code": "NOT_FOUND",
    "message": "The resource requested was not found or is no longer available",
    "requestId": "EXhFdCbfS"
  },
  "meta": {
    "apiEnrollmentVersion": "0.0.1",
    "apiVersion": "0.0.1"
  }
}

Just confirm that controller is at v1.3.3:

{
  "data": {
    "apiVersions": {
      "edge": {
        "v1": {
          "apiBaseUrls": [
            "https://<fqdn>:8441/edge/client/v1"
          ],
          "path": "/edge/client/v1"
        }
      },
      "edge-client": {
        "v1": {
          "apiBaseUrls": [
            "https://<fqdn>:8441/edge/client/v1"
          ],
          "path": "/edge/client/v1"
        }
      },
      "edge-management": {
        "v1": {
          "apiBaseUrls": [
            "https://<fqdn>:8444/edge/management/v1"
          ],
          "path": "/edge/management/v1"
        }
      },
      "health-checks": {
        "v1": {
          "apiBaseUrls": [],
          "path": "/health-checks/v1"
        }
      }
    },
    "buildDate": "2025-01-27T19:27:43Z",
    "capabilities": [],
    "revision": "2a62cc577e45",
    "runtimeVersion": "go1.23.4",
    "version": "v1.3.3"
  },
  "meta": {}
}

Sorry about that. It was an error on my part. I got the endpoint wrong it is /external-jwt-signers not /ext-jwt-signers. Works with the correct endpoint.

It's a good question still. The doc usually has "the latest" doc but you can always get YOUR api by going to https://your.controller.url/edge/management/v1/docs

Personally, I prefer to go to my controller and get the doc from it, just to be sure I'm using the right apis. The doc link is useful when exploring so it still has value imo

Thank you @TheLumberjack . That definitely helps :slight_smile: